Función SecurityDescriptorToBinarySD (adshlp.h)

Artículo
02/28/2024

La función SecurityDescriptorToBinarySD convierte un objeto IADsSecurityDescriptor en el formato del descriptor de seguridad binario.

Sintaxis

HRESULT SecurityDescriptorToBinarySD(
  [in]  VARIANT              vVarSecDes,
  [out] PSECURITY_DESCRIPTOR *ppSecurityDescriptor,
  [out] PDWORD               pdwSDLength,
  [in]  LPCWSTR              pszServerName,
  [in]  LPCWSTR              userName,
  [in]  LPCWSTR              passWord,
  [in]  DWORD                dwFlags
);

Parámetros

[in] vVarSecDes

Tipo: VARIANT

Contiene un valor VARIANT que contiene el descriptor de seguridad que se va a convertir. Variant debe contener un VT_DISPATCH que contenga un objeto IADsSecurityDescriptor.

[out] ppSecurityDescriptor

Tipo: PSECURITY_DESCRIPTOR*

Dirección de un puntero SECURITY_DESCRIPTOR que recibe los datos del descriptor de seguridad binario. El autor de la llamada debe liberar esta memoria pasando este puntero a la función FreeADsMem .

[out] pdwSDLength

Tipo: PDWORD

Dirección de un valor DWORD que recibe la longitud, en bytes de los datos del descriptor de seguridad binario.

[in] pszServerName

Tipo: LPCWSTR

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

[in] userName

Tipo: LPCWSTR

Cadena Unicode terminada en null que contiene el nombre de usuario al que está asociado el descriptor de seguridad. Este parámetro es opcional y puede ser NULL.

[in] passWord

Tipo: LPCWSTR

Cadena Unicode terminada en null que contiene la contraseña asociada 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 de ADS_AUTHENTICATION_ENUM .

Valor devuelto

Tipo: HRESULT

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

Comentarios

Esta función se usa para aplicaciones heredadas para convertir manualmente descriptores de seguridad en descriptores de seguridad binarios. Para las nuevas aplicaciones, use 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