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

Voir aussi

ADS_PATHTYPE_ENUM

ADS_SD_FORMAT_ENUM

IADsSecurityDescriptor

IADsSecurityUtility

SECURITY_DESCRIPTOR

SetSecurityDescriptor