Compartir a través de

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

  • Artículo

Devuelve las marcas de uso de un token asociado a un trabajo de transferencia de BITS.

Sintaxis

HRESULT GetHelperTokenFlags(
  [out] DWORD *pFlags
);

Parámetros

[out] pFlags

Especifica la marca de uso que se va a devolver. Este parámetro debe establecerse en uno de los valores siguientes:

Valor Significado
BG_TOKEN_LOCAL_FILE
0x0001
 Si se especifica esta marca, se usa el token del asistente.
  • Para abrir el archivo local de un trabajo de carga
  • Para crear o cambiar el nombre del archivo temporal de un trabajo de descarga
  • Para crear o cambiar el nombre del archivo de respuesta de un trabajo de carga-respuesta
BG_TOKEN_NETWORK
0x0002
 Si se especifica esta marca, se usa el token del asistente.
  • Para abrir el archivo remoto de un trabajo de carga o descarga del bloque de mensajes del servidor (SMB)
  • En respuesta a un desafío de servidor HTTP o proxy para credenciales NTLM o Kerberos implícitas
Se requiere una aplicación para llamar al método IBackgroundCopyJob2::SetCredentials para permitir que las credenciales se envíen a través de HTTP.

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Las implementaciones anteriores requerían eficazmente que los usuarios de BITS tengan privilegios de administrador para obtener marcas de token auxiliares con este método. A partir de Windows 10, versión 1607, los usuarios que no son administradores de BITS pueden usar este método para obtener marcas de uso de tokens auxiliares en los trabajos de BITS que poseen. Este cambio permite a los usuarios que no son administradores de BITS (como los servicios del descargador en segundo plano que se ejecutan en la cuenta networkService) usar tokens auxiliares de forma eficaz.

En concreto, la implementación se ha cambiado para permitir que los usuarios sin privilegios de administrador obtengan marcas de token auxiliares, siempre y cuando el SID del token del subproceso del autor de la llamada sea el mismo que el SID de la cuenta de usuario del propietario del trabajo durante la llamada A IBackgroundCopyJob::QueryInterface .

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7
Servidor mínimo compatible Windows Server 2008 R2
Plataforma de destino Windows
Encabezado bits4_0.h
Redistribuible Windows Management Framework en Windows Vista con SP1, Windows Vista con SP2 y Windows Server 2008 con SP2

Consulte también

IBitsTokenOptions