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 |
---|---|
|
Metodo completato correttamente. subscriberInformation contiene un'interfaccia valida. |
|
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 |