SpApplyControlTokenFn-Rückruffunktion (ntsecpkg.h)

  • Artikel

Wendet ein Steuerelementtoken auf einen Sicherheitskontext an. Diese Funktion wird derzeit nicht von der lokalen Sicherheitsbehörde (Local Security Authority , LSA) aufgerufen.

Syntax

SpApplyControlTokenFn Spapplycontroltokenfn;

NTSTATUS Spapplycontroltokenfn(
  [in] LSA_SEC_HANDLE ContextHandle,
  [in] PSecBufferDesc ControlToken
)
{...}

Parameter

[in] ContextHandle

Ein Handle für den Sicherheitskontext, der basierend auf dem ControlToken-Parameter geändert werden soll.

[in] ControlToken

Zeiger auf eine SecBufferDesc-Struktur , die das Token enthält, das auf den Kontext angewendet werden soll.

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_INVALID_TOKEN
 Das Token ist ungültig.
SEC_E_INVALID_HANDLE
 Das Handle ist ungültig.

Hinweise

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

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