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

Voir aussi

ADS_PATHTYPE_ENUM

ADS_SD_FORMAT_ENUM

IADsSecurityDescriptor

IADsSecurityUtility