IADsSecurityUtility::ConvertSecurityDescriptor, méthode (iads.h)
La méthode ConvertSecurityDescriptor convertit un descripteur de sécurité d’un format à un autre.
Syntaxe
HRESULT ConvertSecurityDescriptor(
[in] VARIANT varSD,
[in] long lDataFormat,
[in] long lOutFormat,
[out] VARIANT *pResult
);
Paramètres
[in] varSD
VARIANT qui contient le descripteur de sécurité à convertir. Le format de ce VARIANT est défini par le paramètre lDataFormat .
[in] lDataFormat
Contient l’une des valeurs ADS_SD_FORMAT_ENUM qui spécifie le format du descripteur de sécurité dans le paramètre varSD . La liste suivante identifie les valeurs possibles pour ce paramètre et le format du paramètre varSD .
ADS_SD_FORMAT_IID
varSD contient un VT_DISPATCH qui peut être interrogé pour l’interface IADsSecurityDescriptor .
ADS_SD_FORMAT_RAW
varSD contient 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
varSD contient un VT_BSTR qui contient le descripteur de sécurité brut au format de chaîne d’encodage hexadécimal.
[in] lOutFormat
Contient l’une des valeurs ADS_SD_FORMAT_ENUM qui spécifie le format vers lequel le descripteur de sécurité doit être converti. La liste suivante identifie les valeurs possibles pour ce paramètre et le format du paramètre pvResult .
ADS_SD_FORMAT_IID
pvResult reçoit un VT_DISPATCH qui peut être interrogé pour l’interface IADsSecurityDescriptor .
ADS_SD_FORMAT_RAW
pvResult 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
pvResult reçoit un VT_BSTR qui contient le descripteur de sécurité brut au format de chaîne d’encodage hexadécimal.
[out] pResult
Pointeur vers un VARIANT qui reçoit le descripteur de sécurité converti. Le format du descripteur de sécurité récupéré est spécifié par le paramètre lOutFormat .
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
| 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 |