Partager via


IADsSecurityUtility ::GetSecurityDescriptor, méthode (iads.h)

La méthode GetSecurityDescriptor récupère un descripteur de sécurité pour le fichier, le partage de fichiers ou la clé de Registre spécifié.

Syntaxe

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

Paramètres

[in] varPath

Chaîne VARIANT qui contient le chemin d’accès de l’objet pour lequel récupérer le descripteur de sécurité.

Fichier

Syntaxe de chemin d’accès de fichier valide. Par exemple : « c:\specs\public\adxml.doc » ou « \adsi\public\dsclient.exe ».

Partage de fichiers

Syntaxe de chemin de fichier valide pour un partage de fichiers. Par exemple : « \adsi\public ».

Clé de Registre

Syntaxe de Registre valide. Par exemple, « HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\ADs ».

[in] lPathFormat

Contient l’une des valeurs ADS_PATHTYPE_ENUM qui spécifie le format du paramètre varPath .

[in] lFormat

Contient l’une des valeurs ADS_SD_FORMAT_ENUM qui spécifie le format du descripteur de sécurité retourné dans le paramètre pVariant . La liste suivante identifie les valeurs possibles pour ce paramètre et le format fourni dans le paramètre pVariant .

ADS_SD_FORMAT_IID

pVariant reçoit une VT_DISPATCH qui peut être interrogée pour l’interface IADsSecurityDescriptor .

ADS_SD_FORMAT_RAW

pVariant reçoit un VT_ARRAY VT_I1 | qui contient le descripteur de sécurité au format de données brutes. Il s’agit d’une structure de SECURITY_DESCRIPTOR .

ADS_SD_FORMAT_HEXSTRING

pVariant reçoit une VT_BSTR qui contient le descripteur de sécurité brut au format de chaîne d’encodage hexadécimal.

[out] pVariant

Pointeur vers un VARIANT qui reçoit le descripteur de sécurité retourné. Le format du descripteur de sécurité récupéré est spécifié par le paramètre lFormat .

Valeur retournée

Retourne S_OK en cas de réussite ou un code d’erreur COM ou Win32 dans le cas contraire. Les codes d’erreur possibles sont les suivants.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista
Serveur minimal pris en charge Windows Server 2008
Plateforme cible Windows
En-tête iads.h
DLL Activeds.dll

Voir aussi

ADS_PATHTYPE_ENUM

ADS_SD_FORMAT_ENUM

IADsSecurityDescriptor

IADsSecurityUtility

SECURITY_DESCRIPTOR

SetSecurityDescriptor