ISCardVerify::ChangeCode-Methode

Artikel
06/13/2023

[Die ChangeCode-Methode ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Es ist nicht für die Verwendung in Windows Server 2003 mit Service Pack 1 (SP1) und höher, Windows Vista, Windows Server 2008 und nachfolgenden Versionen des Betriebssystems verfügbar. Die Smartcardmodule bieten ähnliche Funktionen.]

Die ChangeCode-Methode ersetzt den aktuellen CHV-Code (Karte Holder Verification) durch neuen CHV-Code.

Syntax

HRESULT ChangeCode(
  [in] LPBYTEBUFFER pOldCode,
  [in] LPBYTEBUFFER pNewCode,
  [in] SCARD_FLAGS  Flags,
  [in] LONG         lRef
);

Parameter

pOldCode [in]

Zeiger auf einen IByteBuffer , der den aktuellen Code des Benutzers enthält.

pNewCode [in]

Zeiger auf einen IByteBuffer, der den neuen Code enthält, der dem intelligenten Karte während des Änderungsprozesses zur Authentifizierung des Benutzers angezeigt wird.

Flaggen [in]

Gibt an, ob der Code global oder lokal ist und ob der Code aktiviert oder deaktiviert werden soll.

SC_FL_IHV_GLOBAL
SC_FL_IHV_LOCAL
SC_FL_IHV_ENABLE
SC_FL_IHV_DISABLE

lRef [in]

Smart Karte spezifische Referenz.

Rückgabewert

Die -Methode gibt einen der folgenden möglichen Werte zurück:

Rückgabecode	BESCHREIBUNG
S_OK	Operation erfolgreich abgeschlossen.
E_INVALIDARG	Ungültiger Parameter.
E_POINTER	Ein fehlerhafter Zeiger wurde übergeben.
E_OUTOFMEMORY	Nicht genügend Arbeitsspeicher.

Bemerkungen

Eine Liste aller von dieser Schnittstelle definierten Methoden finden Sie unter ISCardVerify.

Zusätzlich zu den oben aufgeführten COM-Fehlercodes gibt diese Schnittstelle möglicherweise einen Intelligenten Karte Fehlercode zurück, wenn eine Smart Karte-Funktion aufgerufen wurde, um die Anforderung abzuschließen. Weitere Informationen finden Sie unter Smartcard-Rückgabewerte.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Ende des Supports (Client)	Windows XP
Ende des Supports (Server)	Windows Server 2003

Siehe auch

IByteBuffer
ISCardVerify
Smartcard-Rückgabewerte

Freigeben über