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
S_OK	Die Methode wurde erfolgreich abgeschlossen.
E_PENDING	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.
E_MBN_PIN_REQUIRED	Für das Gerät muss für diesen Vorgang eine PIN eingegeben werden.
E_MBN_SIM_NOT_INSERTED	Die SIM-Karte ist nicht eingefügt.
E_MBN_BAD_SIM	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

Weitere Informationen

IMbnPinManager