Método IADsSecurityUtility::ConvertSecurityDescriptor (iads.h)

Artículo
08/24/2023

El método ConvertSecurityDescriptor convierte un descriptor de seguridad de un formato a otro.

Sintaxis

HRESULT ConvertSecurityDescriptor(
  [in]  VARIANT varSD,
  [in]  long    lDataFormat,
  [in]  long    lOutFormat,
  [out] VARIANT *pResult
);

Parámetros

[in] varSD

Variant que contiene el descriptor de seguridad que se va a convertir. El formato de este variant se define mediante el parámetro lDataFormat .

[in] lDataFormat

Contiene uno de los valores de ADS_SD_FORMAT_ENUM que especifica el formato del descriptor de seguridad en el parámetro varSD . En la lista siguiente se identifican los valores posibles para este parámetro y el formato del parámetro varSD .

ADS_SD_FORMAT_IID

varSD contiene un VT_DISPATCH que se puede consultar para la interfaz IADsSecurityDescriptor .

ADS_SD_FORMAT_RAW

varSD contiene un VT_I1 VT_ARRAY | que contiene el descriptor de seguridad en formato de datos sin procesar. Esto tiene el formato de una estructura SECURITY_DESCRIPTOR .

ADS_SD_FORMAT_HEXSTRING

varSD contiene un VT_BSTR que contiene el descriptor de seguridad sin formato en formato de cadena de codificación hexadecimal.

[in] lOutFormat

Contiene uno de los valores de ADS_SD_FORMAT_ENUM que especifica el formato al que se debe convertir el descriptor de seguridad. En la lista siguiente se identifican los valores posibles para este parámetro y el formato del parámetro pvResult .

ADS_SD_FORMAT_IID

pvResult recibe un VT_DISPATCH que se puede consultar para la interfaz IADsSecurityDescriptor .

ADS_SD_FORMAT_RAW

pvResult recibe un VT_I1 | VT_ARRAY que contiene el descriptor de seguridad en formato de datos sin procesar. Esto tiene el formato de una estructura SECURITY_DESCRIPTOR .

ADS_SD_FORMAT_HEXSTRING

pvResult recibe un VT_BSTR que contiene el descriptor de seguridad sin formato en formato de cadena de codificación hexadecimal.

[out] pResult

Puntero a un VARIANT que recibe el descriptor de seguridad convertido. El formato del descriptor de seguridad recuperado se especifica mediante el parámetro lOutFormat .

Valor devuelto

Devuelve S_OK si el código de error es CORRECTO o COM o Win32. Entre los posibles códigos de error se incluyen los siguientes.

Requisitos


Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	iads.h
Archivo DLL	Activeds.dll