Método IBitsTokenOptions::GetHelperTokenSid (bits4_0.h)

Retorna o SID do token auxiliar se um estiver definido.

Nota Esse método não retorna o token.

 

Sintaxe

HRESULT GetHelperTokenSid(
  [out] LPWSTR *pSid
);

Parâmetros

[out] pSid

Retorna o SID recuperado do parâmetro TokenInformation da função GetTokenInformation . Se nenhum SID for recuperado, esse parâmetro será definido como NULL.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Implementações mais antigas exigiam efetivamente que os usuários do BITS tivessem privilégios de administrador para obter o SID do token auxiliar com esse método. A partir do Windows 10, versão 1607, os usuários de BITS não administradores podem usar esse método para obter o SID do token auxiliar em trabalhos BITS que possuem. Essa alteração permite que usuários BITS não administradores (como serviços de download em segundo plano em execução na conta NetworkService) usem tokens auxiliares com eficiência.

Especificamente, a implementação foi alterada para permitir que usuários sem privilégios de administrador obtenham o SID do token auxiliar, desde que o SID do token do thread do chamador seja o mesmo que o SID da conta de usuário do proprietário do trabalho durante a chamada IBackgroundCopyJob::QueryInterface .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7
Servidor mínimo com suporte	Windows Server 2008 R2
Plataforma de Destino	Windows
Cabeçalho	bits4_0.h
Redistribuível	Windows Management Framework no Windows Vista com SP1, Windows Vista com SP2 e Windows Server 2008 com SP2

Confira também

IBitsTokenOptions