Método IADsSecurityUtility::ConvertSecurityDescriptor (iads.h)
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 |