IADsSecurityUtility::ConvertSecurityDescriptor メソッド (iads.h)

ConvertSecurityDescriptor メソッドは、セキュリティ記述子をある形式から別の形式に変換します。

構文

HRESULT ConvertSecurityDescriptor(
  [in]  VARIANT varSD,
  [in]  long    lDataFormat,
  [in]  long    lOutFormat,
  [out] VARIANT *pResult
);

[in] varSD

変換するセキュリティ記述子を含む VARIANT 。この VARIANT の形式は、 lDataFormat パラメーターによって定義されます。

[in] lDataFormat

varSD パラメーターのセキュリティ記述子の形式を指定するADS_SD_FORMAT_ENUM値のいずれかを格納します。次の一覧では、このパラメーターに使用できる値と varSD パラメーターの形式を示します。

varSD には、IADsSecurityDescriptor インターフェイスに対してクエリを実行できるVT_DISPATCHが含まれています。

varSDには、生データ形式の | セキュリティ記述子を含むVT_I1 VT_ARRAYが含まれています。これは、 SECURITY_DESCRIPTOR 構造体の形式です。

varSD には、生のセキュリティ記述子を 16 進エンコード文字列形式で含む VT_BSTR が含まれています。

[in] lOutFormat

セキュリティ記述子の変換先の形式を指定する ADS_SD_FORMAT_ENUM 値のいずれかを格納します。次の一覧では、このパラメーターに使用できる値と pvResult パラメーターの形式を示します。

pvResult は、IADsSecurityDescriptor インターフェイスに対してクエリを実行できるVT_DISPATCHを受け取ります。

pvResultは、生データ形式の | セキュリティ記述子を含むVT_I1 VT_ARRAYを受け取ります。これは、 SECURITY_DESCRIPTOR 構造体の形式です。

pvResult は、生のセキュリティ記述子を 16 進エンコード文字列形式で含むVT_BSTRを受け取ります。

[out] pResult

変換されたセキュリティ記述子を受け取る VARIANT へのポインター。取得したセキュリティ記述子の形式は、 lOutFormat パラメーターによって指定されます。

成功した場合 はS_OK を返し、それ以外の場合は COM または Win32 エラーコードを返します。考えられるエラーコードは次のとおりです。