SpAddCredentialsFn-Rückruffunktion (ntsecpkg.h)

Artikel
03/04/2024

Wird verwendet, um Anmeldeinformationen für einen Sicherheitsprinzipal hinzuzufügen.

Syntax

SpAddCredentialsFn Spaddcredentialsfn;

NTSTATUS Spaddcredentialsfn(
  [in]  LSA_SEC_HANDLE CredentialHandle,
  [in]  PUNICODE_STRING PrincipalName,
  [in]  PUNICODE_STRING Package,
  [in]  ULONG CredentialUseFlags,
  [in]  PVOID AuthorizationData,
        PVOID GetKeyFunciton,
  [in]  PVOID GetKeyArgument,
  [out] PTimeStamp ExpirationTime
)
{...}

Parameter

[in] CredentialHandle

Ein Handle für die hinzuzufügenden Anmeldeinformationen.

[in] PrincipalName

Optional. Zeiger auf eine UNICODE_STRING-Struktur , die den Namen des Sicherheitsprinzipals enthält, dessen Anmeldeinformationen hinzugefügt werden.

[in] Package

Zeiger auf eine UNICODE_STRING Struktur, die den Namen des authentifizierenden Pakets enthält.

[in] CredentialUseFlags

Flags, die angeben, wie die Anmeldeinformationen verwendet werden. Die folgenden Werte sind gültig.

Wert	Bedeutung
SECPKG_CRED_INBOUND	Anmeldeinformationen werden mit der Funktion AcceptSecurityContext (Allgemein) verwendet.
SECPKG_CRED_OUTBOUND	Anmeldeinformationen werden mit der Funktion InitializeSecurityContext (General) verwendet.

[in] AuthorizationData

Optional. Zeiger auf zusätzliche Authentifizierungsdaten.

GetKeyFunciton

[in] GetKeyArgument

Zeiger auf das Argument, das mit der GetKeyFunction-Funktion verwendet wird.

[out] ExpirationTime

Zeiger auf einen TimeStamp , der die Zeit empfängt, zu der das Handle der Anmeldeinformationen abläuft.

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 einen Fehler angibt.

Hinweise

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

Ein Zeiger auf die SpAddCredentials-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

Freigeben über