SpGetCredentialsFn-Rückruffunktion (ntsecpkg.h)

  • Artikel

Die SpGetCredentials-Funktion ruft die primären und zusätzlichen Anmeldeinformationen aus dem Benutzerobjekt ab.

Syntax

SpGetCredentialsFn Spgetcredentialsfn;

NTSTATUS Spgetcredentialsfn(
  [in]  LSA_SEC_HANDLE CredentialHandle,
  [out] PSecBuffer Credentials
)
{...}

Parameter

[in] CredentialHandle

Ein Handle für die abzurufenden Anmeldeinformationen.

[out] Credentials

Zeiger auf eine SecBuffer-Struktur , die die Anmeldeinformationen empfängt.

Rückgabewert

Wenn die Funktion erfolgreich ist, geben Sie STATUS_SUCCESS zurück.

Wenn die Funktion fehlschlägt, geben Sie einen NTSTATUS-Code zurück, der den Grund für den Fehler angibt. Im Folgenden werden häufige Fehlerursachen und die Fehlercodes aufgeführt, die die Funktion zurückgeben soll.

Rückgabecode Beschreibung
SEC_E_INSUFFICIENT_MEMORY
 Es ist nicht genügend Arbeitsspeicher vorhanden, um die Anmeldeinformationen abzurufen.
SEC_E_INVALID_HANDLE
 Das Handle ist ungültig.

Hinweise

SSP/APs müssen die SpGetCredentials-Funktion implementieren. Der tatsächliche Name, der der Implementierung gegeben wird, liegt jedoch beim Entwickler.

Ein Zeiger auf die SpGetCredentials-Funktion ist in der SECPKG_FUNCTION_TABLE-Struktur verfügbar, die von der SpLsaModeInitialize-Funktion empfangen wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile ntsecpkg.h

Weitere Informationen

SECPKG_FUNCTION_TABLE

SpLsaModeInitialize