SspiGetCredUIContext-Funktion (sspi.h)

Artikel
03/02/2024

Ruft Kontextinformationen von einem Anmeldeinformationsanbieter ab.

Syntax

SECURITY_STATUS SEC_ENTRY SspiGetCredUIContext(
  [in]  HANDLE                           ContextHandle,
  [in]  GUID                             *CredType,
  [in]  LUID                             *LogonId,
  [out] PSEC_WINNT_CREDUI_CONTEXT_VECTOR *CredUIContexts,
  [out] HANDLE                           *TokenHandle
);

Parameter

[in] ContextHandle

Ein Zeiger auf eine SEC_WINNT_CREDUI_CONTEXT-Struktur , die während eines vorherigen Aufrufs der Funktion SspiUnmarshalCredUIContext abgerufen wurde.

[in] CredType

Der Vom ContextHandle-Parameter angegebene Anmeldeinformationstyp. Dies kann einer der folgenden Werte sein.

Wert	Bedeutung
SEC_WINNT_AUTH_DATA_TYPE_PASSWORD 0x28bfc32f, 0x10f6, 0x4738, 0x98, 0xd1, 0x1a, 0xc0, 0x61, 0xdf, 0x71, 0x6a	Die Anmeldeinformationen sind ein Kennwort.
SEC_WINNT_AUTH_DATA_TYPE_CERT 0x235f69ad, 0x73fb, 0x4dbc, 0x82, 0x3, 0x6, 0x29, 0xe7, 0x39, 0x33, 0x9b	Die Anmeldeinformationen sind ein Zertifikat.
SEC_WINNT_AUTH_DATA_TYPE_CSP_DATA 0x68fd9879, 0x79c, 0x4dfe, 0x82, 0x81, 0x57, 0x8a, 0xad, 0xc1, 0xc1, 0x0	Die Anmeldeinformationen sind Authentifizierungsdaten eines Kryptografiedienstanbieters (CSP ).

[in] LogonId

Die Anmelde-ID, die den vom ContextHandle-Parameter angegebenen Anmeldeinformationen zugeordnet ist.

Der Aufrufer muss als LocalSystem ausgeführt werden, um eine Anmelde-ID anzugeben.

[out] CredUIContexts

Ein Zeiger auf eine SEC_WINNT_CREDUI_CONTEXT_VECTOR-Struktur , die den Offset und die Größe der Daten in der durch den ContextHandle-Parameter angegebenen Struktur angibt.

[out] TokenHandle

Ein Handle für das Token des angegebenen Benutzers.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird SEC_E_OK zurückgegeben.

Wenn die Funktion fehlschlägt, wird ein Fehlercode ungleich null zurückgegeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	sspi.h
Bibliothek	Credui.lib
DLL	Credui.dll

Freigeben über