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

Consulte también

ADS_PATHTYPE_ENUM

ADS_SD_FORMAT_ENUM

IADsSecurityDescriptor

IADsSecurityUtility

SECURITY_DESCRIPTOR

SetSecurityDescriptor