SpApplyControlTokenFn-Rückruffunktion (ntsecpkg.h)
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 |
|---|---|
|
Das Token ist ungültig. |
|
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 |