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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour