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 |