SecurityDescriptorToBinarySD 関数 (adshlp.h)

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

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

構文

HRESULT SecurityDescriptorToBinarySD(
  [in]  VARIANT              vVarSecDes,
  [out] PSECURITY_DESCRIPTOR *ppSecurityDescriptor,
  [out] PDWORD               pdwSDLength,
  [in]  LPCWSTR              pszServerName,
  [in]  LPCWSTR              userName,
  [in]  LPCWSTR              passWord,
  [in]  DWORD                dwFlags
);

パラメーター

[in] vVarSecDes

型: VARIANT

変換するセキュリティ記述子を含む VARIANT が含まれます。 VARIANT には、IADsSecurityDescriptor オブジェクトを含むVT_DISPATCHが含まれている必要があります。

[out] ppSecurityDescriptor

種類: PSECURITY_DESCRIPTOR*

バイナリセキュリティ記述子データを受け取る SECURITY_DESCRIPTOR ポインターのアドレス。呼び出し元は、このポインターを FreeADsMem 関数に渡すことによって、このメモリを解放する必要があります。

[out] pdwSDLength

型: PDWORD

バイナリセキュリティ記述子データの長さをバイト単位で受け取る DWORD 値のアドレス。

[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

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

注釈

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

要件

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