• SAT Client API For connecting SAT Session

  // How to connect to SAT service :
  // How to request notification on SetupIdleModeText change:

  RSatSession satSession;
  RSatService satService;
  // Connect session
  satSession.ConnectL();
  satService.OpenL( satSession );
  // Start observing asynchronously for changes
  satService.NotifySetupIdleModeTextChange( status );
  
  //How to read Idle Mode Text and icon:

  // Read text and icon after startup and when notified about change.
  TSatIconQualifier iconQualif( ESatIconNoIcon );
  TUint8 recordId( 0 );
  TInt error( KErrNone );
  HBufC* text = NULL;
  satService.GetSetupIdleModeTextL( 
    text, iconQualif, recordId );
  CFbsBitmap* icon = NULL;
  if ( text )
      {
      // Use text, take care of cleanup.
      }
  if ( ESatIconNoIcon != iconQualif )
      {
      // There's an icon to be displayed.
      // Get icon records into array.
      RIconEf iconInfos;
      CleanupStack::PushL( TCleanupItem( 
          LocalArrayCleanupFunction, iconInfos )
      satService.GetIconInfoL( recordId, iconInfos );

      // Resolve which icon to use using icon infos.
      // Then get the icon you selected.
      icon = satService.GetIconL( iconInfos[ 0 ] );
      CleanupStack::PopAndDestroy(); // iconInfos

      if ( ESatIconSelfExplanatory == iconQualif )
          {
          // Only icon should be displayed.
          }
      else if ( ESatIconNotSelfExplanatory == iconQualif )
          {
          // Both text and icon should be displayed.
          }
      }
  // else: only text should be displayed
  
  // Display text and/or icon, take care of their cleanup.

Since

5.1