IMbnPinEvents::OnEnableComplete-Methode (mbnapi.h)

Benachrichtigungsmethode, die vom mobilen Breitbanddienst aufgerufen wird, um anzugeben, dass ein PIN-Aktivierungsvorgang abgeschlossen wurde.

Syntax

HRESULT OnEnableComplete(
  [in] IMbnPin      *pin,
  [in] MBN_PIN_INFO *pinInfo,
  [in] ULONG        requestID,
  [in] HRESULT      status
);

Parameter

[in] pin

Eine IMbnPin-Schnittstelle , die den PIN-Typ darstellt.

[in] pinInfo

Ein Zeiger auf eine MBN_PIN_INFO-Struktur , die Informationen zu verbleibenden Versuchen enthält, wenn Fehlervorgänge vorliegen. Der Inhalt von pinInfo ist nur dann sinnvoll, wenn statusE_MBN_FAILURE ist.

[in] requestID

Eine Anforderungs-ID, die vom Mobilen Breitbanddienst festgelegt wird, um die PIN-Aktivierungsanforderung zu identifizieren.

[in] status

Ein status Code, der das Ergebnis des Vorgangs angibt.

Eine aufrufende Anwendung kann einen der folgenden Werte erwarten.

Rückgabewert

Diese Methode muss S_OK zurückgeben.

Hinweise

Die OnEnableComplete-Methode wird vom Mobilen Breitbanddienst aufgerufen, um den Abschluss status eines PIN-Aktivierungsvorgangs zu melden, der durch einen Aufruf der Enable-Methode von IMbnPin initialisiert wurde.

Der Inhalt von pinInfo ist nur dann sinnvoll, wenn statusE_MBN_FAILURE ist. Das pinState-Element sollte ignoriert werden, und das PinType-Feld ist auf den PIN-Typ der aktuellen IMbnPin-Schnittstelle festgelegt. Diese Struktur enthält die verbleibenden Versuche, eine gültige PIN einzugeben.

Wenn beispielsweise die zum Ändern eines PIN-Typs übergebene PIN falsch ist, schlägt der Vorgang mit einem status Code von E_MBN_FAILURE fehl. In diesem Fall gibt pinInfo.attemptsRemaining die Anzahl der verbleibenden Versuche an, um diesen Vorgang zu wiederholen. Wenn wiederholte Versuche mit der falschen PIN dazu führen, dass attemptsRemaining zu 0 wird, kann die Anwendung die GetPinState-Methode von IMbnPinManager aufrufen, um den typ der erforderlichen PIN abzurufen.

Anforderungen

Weitere Informationen

IMbnPinEvents