Condividi tramite


Metodo IADsSecurityUtility::GetSecurityDescriptor (iads.h)

Il metodo GetSecurityDescriptor recupera un descrittore di sicurezza per il file, la condivisione file o la chiave del Registro di sistema specificata.

Sintassi

HRESULT GetSecurityDescriptor(
  [in]  VARIANT varPath,
  [in]  long    lPathFormat,
  [in]  long    lFormat,
  [out] VARIANT *pVariant
);

Parametri

[in] varPath

Stringa VARIANT che contiene il percorso dell'oggetto per il quale recuperare il descrittore di sicurezza.

File

Sintassi del percorso di file valida. Ad esempio: "c:\specs\public\adxml.doc" o "\adsi\public\dsclient.exe".

Condivisione file

Sintassi del percorso di file valida per una condivisione file. Ad esempio: "\adsi\public".

Chiave del Registro di sistema

Sintassi valida del Registro di sistema. Ad esempio, "HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\ADs".

[in] lPathFormat

Contiene uno dei valori ADS_PATHTYPE_ENUM che specifica il formato del parametro varPath .

[in] lFormat

Contiene uno dei valori ADS_SD_FORMAT_ENUM che specifica il formato del descrittore di sicurezza restituito nel parametro pVariant . Nell'elenco seguente vengono identificati i valori possibili per questo parametro e il formato fornito nel parametro pVariant .

ADS_SD_FORMAT_IID

pVariant riceve un VT_DISPATCH su cui è possibile eseguire una query per l'interfaccia IADsSecurityDescriptor .

ADS_SD_FORMAT_RAW

pVariant riceve un VT_I1 VT_ARRAY | che contiene il descrittore di sicurezza in formato dati non elaborato. Questo è nel formato di una struttura SECURITY_DESCRIPTOR .

ADS_SD_FORMAT_HEXSTRING

pVariant riceve un VT_BSTR che contiene il descrittore di sicurezza non elaborato in formato stringa con codifica esadecimale.

[out] pVariant

Puntatore a un valore VARIANT che riceve il descrittore di sicurezza restituito. Il formato del descrittore di sicurezza recuperato viene specificato dal parametro lFormat .

Valore restituito

Restituisce S_OK se ha esito positivo o se un codice di errore COM o Win32 in caso contrario. I codici di errore possibili includono quanto segue.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista
Server minimo supportato Windows Server 2008
Piattaforma di destinazione Windows
Intestazione iads.h
DLL Activeds.dll

Vedi anche

ADS_PATHTYPE_ENUM

ADS_SD_FORMAT_ENUM

IADsSecurityDescriptor

IADsSecurityUtility

SECURITY_DESCRIPTOR

SetSecurityDescriptor