Condividi tramite


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.

Fabbisogno

Requisito Valore
client minimo supportato Windows 2000
piattaforma di destinazione Universale
intestazione ntifs.h (include FltKernel.h, Ntifs.h)
libreria NtosKrnl.lib
dll NtosKrnl.exe
IRQL PASSIVE_LEVEL
regole di conformità DDI HwStorPortProhibitedDDIs(storport)

Vedere anche

ObDereferenceObject

PsDereferenceImpersonationToken

PsImpersonateClient

SECURITY_IMPERSONATION_LEVEL