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 |