Método IADsSecurityUtility::GetSecurityDescriptor (iads.h)
El método GetSecurityDescriptor recupera un descriptor de seguridad para el archivo, el recurso compartido de archivos o la clave del Registro especificados.
Sintaxis
HRESULT GetSecurityDescriptor(
[in] VARIANT varPath,
[in] long lPathFormat,
[in] long lFormat,
[out] VARIANT *pVariant
);
Parámetros
[in] varPath
Cadena VARIANT que contiene la ruta de acceso del objeto para la que se va a recuperar el descriptor de seguridad.
Archivo
Una sintaxis de ruta de acceso de archivo válida. Por ejemplo: "c:\specs\public\adxml.doc" o "\adsi\public\dsclient.exe".
Recurso compartido de archivos
Una sintaxis de ruta de acceso de archivo válida para un recurso compartido de archivos. Por ejemplo: "\adsi\public".
Clave del Registro
Sintaxis del Registro válida. Por ejemplo, "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\ADs".
[in] lPathFormat
Contiene uno de los valores de ADS_PATHTYPE_ENUM que especifica el formato del parámetro varPath .
[in] lFormat
Contiene uno de los valores de ADS_SD_FORMAT_ENUM que especifica el formato del descriptor de seguridad devuelto en el parámetro pVariant . En la lista siguiente se identifican los valores posibles para este parámetro y el formato proporcionado en el parámetro pVariant .
ADS_SD_FORMAT_IID
pVariant recibe un VT_DISPATCH que se puede consultar para la interfaz IADsSecurityDescriptor .
ADS_SD_FORMAT_RAW
pVariant recibe un VT_ARRAY VT_I1 | 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
pVariant recibe un VT_BSTR que contiene el descriptor de seguridad sin formato en formato de cadena de codificación hexadecimal.
[out] pVariant
Puntero a un VARIANT que recibe el descriptor de seguridad devuelto. El formato del descriptor de seguridad recuperado se especifica mediante el parámetro lFormat .
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
Requisito | Value |
---|---|
Cliente mínimo compatible | Windows Vista |
Servidor mínimo compatible | Windows Server 2008 |
Plataforma de destino | Windows |
Encabezado | iads.h |
Archivo DLL | Activeds.dll |