Compartilhar via

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

  • Artigo

Retorna os sinalizadores de uso para um token associado a um trabalho de transferência de BITS.

Sintaxe

HRESULT GetHelperTokenFlags(
  [out] DWORD *pFlags
);

Parâmetros

[out] pFlags

Especifica o sinalizador de uso a ser retornado. Esse parâmetro deve ser definido como um dos seguintes valores:

Valor Significado
BG_TOKEN_LOCAL_FILE
0x0001
 Se esse sinalizador for especificado, o token auxiliar será usado
  • Para abrir o arquivo local de um trabalho de upload
  • Para criar ou renomear o arquivo temporário de um trabalho de download
  • Para criar ou renomear o arquivo de resposta de um trabalho de upload-reply
BG_TOKEN_NETWORK
0x0002
 Se esse sinalizador for especificado, o token auxiliar será usado
  • Para abrir o arquivo remoto de um trabalho de upload ou download de um SMB (Bloco de Mensagens do Servidor)
  • Em resposta a um desafio de servidor HTTP ou proxy para credenciais NTLM ou Kerberos implícitas
Um aplicativo é necessário para chamar o método IBackgroundCopyJob2::SetCredentials para permitir que as credenciais sejam enviadas por HTTP.

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 sinalizadores de 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 sinalizadores de uso de 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 sinalizadores de 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