Función BinarySDToSecurityDescriptor (adshlp.h)

Artículo
02/26/2024

La función BinarySDToSecurityDescriptor convierte un descriptor de seguridad binario en un objeto IADsSecurityDescriptor .

Sintaxis

HRESULT BinarySDToSecurityDescriptor(
  [in]  PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [out] VARIANT              *pVarsec,
  [in]  LPCWSTR              pszServerName,
  [in]  LPCWSTR              userName,
  [in]  LPCWSTR              passWord,
  [in]  DWORD                dwFlags
);

Parámetros

[in] pSecurityDescriptor

Tipo: PSECURITY_DESCRIPTOR

Dirección de una estructura de SECURITY_DESCRIPTOR que se va a convertir.

[out] pVarsec

Tipo: VARIANT*

Dirección de un variant que recibe el objeto . Variant contiene un objeto VT_DISPATCH que se puede consultar para la interfaz IADsSecurityDescriptor. El autor de la llamada debe liberar esta VARIANTpasando variant a la función VariantClear .

[in] pszServerName

Tipo: LPCWSTR

Cadena Unicode terminada en null que proporciona el nombre del servidor del que se recuperó el descriptor de seguridad. Este parámetro es opcional y puede ser NULL.

[in] userName

Tipo: LPCWSTR

Cadena Unicode terminada en null que proporciona el nombre de usuario que se va a asociar al descriptor de seguridad. Este parámetro es opcional y puede ser NULL.

[in] passWord

Tipo: LPCWSTR

Cadena Unicode terminada en null que proporciona la contraseña que se va a asociar al descriptor de seguridad. Este parámetro es opcional y puede ser NULL.

[in] dwFlags

Tipo: DWORD

Contiene marcas de autenticación para la conversión. Puede ser cero o una combinación de uno o varios de los valores de enumeración ADS_AUTHENTICATION_ENUM .

Valor devuelto

Tipo: HRESULT

Este método admite valores devueltos estándar, así como los siguientes:

Si se produce un error en la operación, se devuelve un código de error ADSI. Para obtener más información, consulta Códigos de error adsi.

Comentarios

Esta función se usa para las aplicaciones heredadas que deben convertir manualmente descriptores de seguridad en descriptores de seguridad binarios. Para las nuevas aplicaciones, use la interfaz IADsSecurityUtility , que realiza esta conversión automáticamente.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	adshlp.h
Library	Activeds.lib
Archivo DLL	Activeds.dll