IADsSecurityUtility::ConvertSecurityDescriptor, méthode (iads.h)

Article
08/24/2023

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