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

Devuelve el SID del token auxiliar si se establece uno.

Nota Este método no devuelve el token.

 

Sintaxis

HRESULT GetHelperTokenSid(
  [out] LPWSTR *pSid
);

Parámetros

[out] pSid

Devuelve el SID que se recupera del parámetro TokenInformation de la función GetTokenInformation . Si no se recupera ningún SID, este parámetro se establece en NULL.

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 requieren eficazmente que los usuarios de BITS tengan privilegios de administrador para obtener el SID del token auxiliar 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 el SID del token auxiliar en los trabajos de BITS que poseen. Este cambio permite a los usuarios de BITS que no son administradores (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 el SID del token auxiliar, 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