Método IBitsTokenOptions::ClearHelperToken (bits4_0.h)
Descarta o token auxiliar e não altera os sinalizadores de uso.
Sintaxe
HRESULT ClearHelperToken();
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 limpar um 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 limpar tokens auxiliares 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 limpem um 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 |