Condividi tramite


Metodo IMbnInterface::GetSubscriberInformation (mbnapi.h)

Importante

A partire da Windows 10 versione 1803, le API Win32 descritte in questa sezione vengono sostituite dalle API Windows Runtime nello spazio dei nomi Windows.Networking.Connectivity.

Ottiene le informazioni sul sottoscrittore.

Sintassi

HRESULT GetSubscriberInformation(
  [out, retval] IMbnSubscriberInformation **subscriberInformation
);

Parametri

[out, retval] subscriberInformation

Puntatore all'indirizzo di un'interfaccia IMbnSubscriberInformation che contiene informazioni sui sottoscrittori per il dispositivo. Se questo metodo restituisce qualsiasi valore diverso da S_OK, questo parametro è NULL.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito Descrizione
S_OK
Metodo completato correttamente. subscriberInformation contiene un'interfaccia valida.
E_PENDING
Le informazioni non sono disponibili. Il servizio Mobile Broadband sta attualmente verificando le informazioni. L'applicazione chiamante può ricevere una notifica quando le informazioni sono disponibili registrando per il metodo OnSubscriberInformationChange di IMbnInterfaceEvents.

Commenti

Il metodo GetSubscriberInformation restituisce le informazioni correlate al sottoscrittore, inclusi l'ID sottoscrittore, il numero di scheda internazionale SIM e i numeri di telefono associati a questa interfaccia.

Quando questo metodo viene chiamato da un'app di Windows Store con privilegi di operatore mobile, restituirà solo il numero di scheda del circuito SIM International definito dalla proprietà SimIccID .

Alcuni dei valori restituiti nelle informazioni del sottoscrittore vengono popolati solo quando lo stato pronto segnalato dal metodo GetReadyState di IMbnInterface è MBN_READY_STATE_INITIALIZED. Ogni volta che si verifica una modifica nelle informazioni del sottoscrittore associate al dispositivo Mobile Broadband, il servizio Mobile Broadband notifica le applicazioni registrate chiamando il metodo OnSubscriberInformationChange di IMbnInterfaceEvents.

Le informazioni sui sottoscrittori per un dispositivo non cambieranno dopo che lo stato pronto per il dispositivo è MBN_READY_STATE_INITIALIZED.

Requisiti

Requisito Valore
Client minimo supportato Windows 7 [app desktop | App UWP]
Server minimo supportato Nessuno supportato
Piattaforma di destinazione Windows
Intestazione mbnapi.h

Vedi anche

IMbnInterface