Função SeCreateClientSecurity (ntifs.h)
A rotina SeCreateClientSecurity inicializa uma estrutura de contexto de cliente de segurança com as informações necessárias para chamar SeImpersonateClientEx.
Sintaxe
NTSTATUS SeCreateClientSecurity(
[in] PETHREAD ClientThread,
[in] PSECURITY_QUALITY_OF_SERVICE ClientSecurityQos,
BOOLEAN RemoteSession,
[out] PSECURITY_CLIENT_CONTEXT ClientContext
);
Parâmetros
[in] ClientThread
Ponteiro para o thread do cliente a ser representado.
[in] ClientSecurityQos
Ponteiro para uma estrutura de SECURITY_QUALITY_OF_SERVICE alocada pelo chamador que indica qual forma de representação deve ser executada.
RemoteSession
Defina como TRUE se o servidor da solicitação do cliente for remoto.
[out] ClientContext
Ponteiro para uma estrutura de SECURITY_CLIENT_CONTEXT alocada pelo chamador a ser inicializada.
Retornar valor
Código de retorno | Descrição |
---|---|
STATUS_SUCCESS | O contexto do cliente de segurança foi inicializado com êxito. |
STATUS_BAD_IMPERSONATION_LEVEL | O cliente a ser representado atualmente representa um cliente próprio e um dos seguintes é verdadeiro: (1) O token efetivo do cliente não pode ser passado para uso por outro servidor, pois seu nível de representação é SecurityAnonymous ou SecurityIdentification. (2) ServerIsRemote é TRUE e o thread do cliente está representando seu cliente em outro nível de SecurityDelegation . |
Comentários
SeCreateClientSecurity inicializa um bloco de contexto de segurança do cliente para representar o contexto de segurança de um cliente.
Se o membro ContextTrackingMode de ClientSecurityQos estiver definido como SECURITY_DYNAMIC_TRACKING e ServerIsRemote for definido como FALSE, SeCreateClientSecurity usará uma referência ao token efetivo do cliente. Caso contrário, SeCreateClientSecurity criará uma cópia do token do cliente.
Cada chamada para SeCreateClientSecurity deve ser correspondida por uma chamada subsequente para SeDeleteClientSecurity.
Para obter mais informações sobre segurança e controle de acesso, consulte Modelo de segurança do Windows para desenvolvedores de driver e a documentação sobre esses tópicos no SDK do Windows.
Requisitos
Requisito | Valor |
---|---|
Plataforma de Destino | Universal |
Cabeçalho | ntifs.h (inclua Ntifs.h) |
Biblioteca | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |