Fonction BinarySDToSecurityDescriptor (adshlp.h)
La fonction BinarySDToSecurityDescriptor convertit un descripteur de sécurité binaire en objet IADsSecurityDescriptor .
Syntaxe
HRESULT BinarySDToSecurityDescriptor(
[in] PSECURITY_DESCRIPTOR pSecurityDescriptor,
[out] VARIANT *pVarsec,
[in] LPCWSTR pszServerName,
[in] LPCWSTR userName,
[in] LPCWSTR passWord,
[in] DWORD dwFlags
);
Paramètres
[in] pSecurityDescriptor
Type : PSECURITY_DESCRIPTOR
Adresse d’une structure SECURITY_DESCRIPTOR à convertir.
[out] pVarsec
Type : VARIANT*
Adresse d’un VARIANT qui reçoit l’objet. Variant contient un objet VT_DISPATCH qui peut être interrogé pour l’interface IADsSecurityDescriptor. L’appelant doit libérer ce VARIANT en passant le VARIANT à la fonction VariantClear .
[in] pszServerName
Type : LPCWSTR
Chaîne Unicode terminée par null qui fournit le nom du serveur à partir duquel le descripteur de sécurité a été récupéré. Ce paramètre est facultatif et peut être NULL.
[in] userName
Type : LPCWSTR
Chaîne Unicode terminée par null qui fournit le nom d’utilisateur à associer au descripteur de sécurité. Ce paramètre est facultatif et peut être NULL.
[in] passWord
Type : LPCWSTR
Chaîne Unicode terminée par null qui fournit le mot de passe à associer au descripteur de sécurité. Ce paramètre est facultatif et peut être NULL.
[in] dwFlags
Type : DWORD
Contient des indicateurs d’authentification pour la conversion. Il peut s’agir de zéro ou d’une combinaison d’une ou plusieurs valeurs d’énumération ADS_AUTHENTICATION_ENUM .
Valeur retournée
Type : HRESULT
Cette méthode prend en charge les valeurs de retour standard, ainsi que les éléments suivants :
Si l’opération échoue, un code d’erreur ADSI est retourné. Pour plus d’informations, consultez Codes d’erreur ADSI.
Remarques
Cette fonction est utilisée pour les applications héritées qui doivent convertir manuellement des descripteurs de sécurité en descripteurs de sécurité binaires. Pour les nouvelles applications, utilisez l’interface IADsSecurityUtility , qui effectue cette conversion automatiquement.
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 | adshlp.h |
| Bibliothèque | Activeds.lib |
| DLL | Activeds.dll |