Funzione PsReferenceImpersonationToken (ntifs.h)

  • Articolo

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 numero di 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 invece. 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 è consentito per abilitare i gruppi e i 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 è consentito 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.

Commenti

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 numero di riferimenti del token di rappresentazione deve essere decrementato chiamando una delle funzioni seguenti:

  • ObDereferenceObject per Windows 2000
  • PsDereferenceImpersonationToken, per Microsoft Windows XP o versioni successive

Per altre informazioni sul controllo di sicurezza e accesso, vedere Modello di sicurezza di Windows per sviluppatori driver e la documentazione su questi argomenti in Windows SDK.

Requisiti

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 HwStorPortProhibitedDDDIs(storport)

Vedi anche

ObDereferenceObject

PsDereferenceImpersonationToken

PsImpersonateClient

SECURITY_IMPERSONATION_LEVEL