BinarySDToSecurityDescriptor 関数 (adshlp.h)

[アーティクル]
02/23/2024

BinarySDToSecurityDescriptor 関数は、バイナリセキュリティ記述子を IADsSecurityDescriptor オブジェクトに変換します。

構文

HRESULT BinarySDToSecurityDescriptor(
  [in]  PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [out] VARIANT              *pVarsec,
  [in]  LPCWSTR              pszServerName,
  [in]  LPCWSTR              userName,
  [in]  LPCWSTR              passWord,
  [in]  DWORD                dwFlags
);

パラメーター

[in] pSecurityDescriptor

種類: PSECURITY_DESCRIPTOR

変換する SECURITY_DESCRIPTOR 構造体のアドレス。

[out] pVarsec

型: VARIANT*

オブジェクトを受け取る VARIANT のアドレス。 VARIANT には、IADsSecurityDescriptor インターフェイスに対してクエリを実行できるVT_DISPATCH オブジェクトが含まれています。呼び出し元は、VARIANT をVariantClear 関数に渡すことによって、この VARIANT を解放する必要があります。

[in] pszServerName

種類: LPCWSTR

セキュリティ記述子が取得されたサーバーの名前を提供する null で終わる Unicode 文字列。このパラメーターは省略可能であり、 NULL にすることができます。

[in] userName

種類: LPCWSTR

セキュリティ記述子に関連付けるユーザー名を提供する null で終わる Unicode 文字列。このパラメーターは省略可能であり、 NULL にすることができます。

[in] passWord

種類: LPCWSTR

セキュリティ記述子に関連付けるパスワードを提供する null で終わる Unicode 文字列。このパラメーターは省略可能であり、 NULL にすることができます。

[in] dwFlags

型: DWORD

変換の認証フラグが含まれています。 0 または 1 つ以上の ADS_AUTHENTICATION_ENUM 列挙値の組み合わせを指定できます。

戻り値

型: HRESULT

このメソッドは、標準の戻り値と、次の値をサポートします。

操作が失敗した場合は、ADSI エラーコードが返されます。詳細については、「 ADSI エラーコード」を参照してください。

注釈

この関数は、セキュリティ記述子をバイナリセキュリティ記述子に手動で変換する必要があるレガシアプリケーションに使用されます。新しいアプリケーションの場合は、この変換を自動的に行う IADsSecurityUtility インターフェイスを使用します。

要件

要件	値
サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
対象プラットフォーム	Windows
ヘッダー	adshlp.h
Library	Activeds.lib
[DLL]	Activeds.dll