Fonction SecurityDescriptorToBinarySD (adshlp.h)
La fonction SecurityDescriptorToBinarySD convertit un objet IADsSecurityDescriptor au format de descripteur de sécurité binaire.
Syntaxe
HRESULT SecurityDescriptorToBinarySD(
[in] VARIANT vVarSecDes,
[out] PSECURITY_DESCRIPTOR *ppSecurityDescriptor,
[out] PDWORD pdwSDLength,
[in] LPCWSTR pszServerName,
[in] LPCWSTR userName,
[in] LPCWSTR passWord,
[in] DWORD dwFlags
);
Paramètres
[in] vVarSecDes
Type : VARIANT
Contient un VARIANT qui contient le descripteur de sécurité à convertir. Variant doit contenir un VT_DISPATCH qui contient un objet IADsSecurityDescriptor.
[out] ppSecurityDescriptor
Type : PSECURITY_DESCRIPTOR*
Adresse d’un pointeur SECURITY_DESCRIPTOR qui reçoit les données de descripteur de sécurité binaire. L’appelant doit libérer cette mémoire en passant ce pointeur à la fonction FreeADsMem .
[out] pdwSDLength
Type : PDWORD
Adresse d’une valeur DWORD qui reçoit la longueur, en octets, des données de descripteur de sécurité binaire.
[in] pszServerName
Type : LPCWSTR
Chaîne Unicode terminée par null qui spécifie le nom du serveur où le descripteur de sécurité est placé. Ce paramètre est facultatif et peut être NULL.
[in] userName
Type : LPCWSTR
Chaîne Unicode terminée par null qui contient le nom d’utilisateur auquel le descripteur de sécurité est associé. Ce paramètre est facultatif et peut être NULL.
[in] passWord
Type : LPCWSTR
Chaîne Unicode terminée par null qui contient le mot de passe associé 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.
Remarques
Cette fonction est utilisée pour les applications héritées afin de convertir manuellement des descripteurs de sécurité en descripteurs de sécurité binaires. Pour les nouvelles applications, utilisez 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 |