Funzione PsReferenceImpersonationToken (ntifs.h)
La routine PsReferenceImpersonationToken incrementa il conteggio dei riferimenti del token di rappresentazione per il thread specificato.
Sintassi
PACCESS_TOKEN PsReferenceImpersonationToken(
[in, out] PETHREAD Thread,
[out] PBOOLEAN CopyOnOpen,
[out] PBOOLEAN EffectiveOnly,
[out] PSECURITY_IMPERSONATION_LEVEL ImpersonationLevel
);
Parametri
[in, out] Thread
Indirizzo del thread il cui conteggio dei riferimenti del token di rappresentazione deve essere incrementato.
[out] CopyOnOpen
Puntatore a una variabile booleana allocata dal chiamante. In caso contrario, questo parametro riceve TRUE se il token non può essere aperto direttamente. In questo caso, il token deve essere duplicato e il token duplicato deve essere usato. Se il token può essere aperto direttamente, questo parametro riceve FALSE.
[out] EffectiveOnly
Puntatore a una variabile booleana allocata dal chiamante. In caso contrario, questo parametro riceve FALSE se il thread è autorizzato ad abilitare gruppi e privilegi attualmente disabilitati nel contesto di sicurezza client, TRUE in caso contrario.
[out] ImpersonationLevel
Puntatore a una variabile SECURITY_IMPERSONATION_LEVEL allocata dal chiamante. In caso di restituzione, questo parametro riceve un valore che specifica il livello di rappresentazione a cui il thread è autorizzato ad accedere al token.
Valore restituito
PsReferenceImpersonationToken restituisce un puntatore al token di rappresentazione per il thread specificato. Se il thread non rappresenta attualmente un client, viene restituito un puntatore NULL.
Osservazioni
Se il thread rappresenta attualmente un client, PsReferenceImpersonationToken incrementa il conteggio dei riferimenti del token di rappresentazione e restituisce un puntatore al token. Se il puntatore restituito non èNULL, il conteggio dei riferimenti del token di rappresentazione deve essere decrementato chiamando una delle funzioni seguenti:
- ObDereferenceObjectper Windows 2000
- PsDereferenceImpersonationToken, per Microsoft Windows XP o versione successiva
Per altre informazioni sulla sicurezza e sul controllo di accesso, vedere modello di sicurezza di Windows per sviluppatori di driver e la documentazione su questi argomenti in Windows SDK.