Método IBitsTokenOptions::GetHelperTokenSid (bits4_0.h)
Retorna o SID do token auxiliar se um estiver definido.
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 |