IMbnPinManager::GetPinList-Methode (mbnapi.h)
Wichtig
Ab Windows 10 Version 1803 werden die in diesem Abschnitt beschriebenen Win32-APIs durch die Windows-Runtime-APIs im Windows.Networking.Connectivity-Namespace ersetzt.
Ruft eine Liste mit verschiedenen PIN-Typen ab, die vom Gerät unterstützt werden.
Syntax
HRESULT GetPinList(
[out, retval] SAFEARRAY **pinList
);
Parameter
[out, retval] pinList
Ein Zeiger auf eine Liste von MBN_PIN_TYPE Werten, die die vom Gerät unterstützten PIN-Typen darstellen. Wenn GetPinList etwas anderes als S_OK zurückgibt, ist pinListNULL. Andernfalls muss die aufrufende Anwendung den zugeordneten Arbeitsspeicher durch Aufrufen von SafeArrayDestroy freigeben.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
Rückgabecode | BESCHREIBUNG |
---|---|
|
Die Methode wurde erfolgreich abgeschlossen. |
|
Die PIN-Typen sind nicht verfügbar. Der mobile Breitbanddienst durchscheckt derzeit das Gerät, um die Informationen abzurufen. Wenn die PIN-Typen verfügbar sind, ruft der Mobile Broadband-Dienst die OnPinListAvailable-Methode von IMbnPinManagerEvents auf. |
|
Für das Gerät muss für diesen Vorgang eine PIN eingegeben werden. |
|
Die SIM-Karte ist nicht eingefügt. |
|
Eine ungültige SIM-Karte wird in das Gerät eingefügt. |
Hinweise
Bei den behebbaren Fehlern E_MBN_PIN_REQUIRED, E_MBN_SIM_NOT_INSERTED und E_MBN_BAD_SIM versucht der mobile Breitbanddienst, diese Informationen vom Gerät abzurufen, wenn die Fehlerbedingung abgelaufen ist. Beim Abrufen dieser Informationen gibt der GetPinList-AufrufE_PENDING zurück. Sobald der Abrufvorgang abgeschlossen ist, ruft der Mobile Broadband-Dienst die OnPinListAvailable-Methode von IMbnPinManagerEvents auf.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows 7 [Desktop-Apps | UWP-Apps] |
Unterstützte Mindestversion (Server) | Nicht unterstützt |
Zielplattform | Windows |
Kopfzeile | mbnapi.h |