IMbnPinManager::GetPinList-Methode (mbnapi.h)

  • Artikel

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