DsListRolesW 関数 (ntdsapi.h)

[アーティクル]
11/20/2024

DsListRoles 関数は、サーバーによって認識されるロールを一覧表示します。

構文

NTDSAPI DWORD DsListRolesW(
  [in]  HANDLE           hDs,
  [out] PDS_NAME_RESULTW *ppRoles
);

パラメーター

[in] hDs

DSBind または DSBindWithCred 関数から取得したディレクトリサービスハンドル含まれます。

[out] ppRoles

サーバーが認識するロールを含む DS_NAME_RESULT 構造体へのポインターを受け取る変数へのポインター。返される構造体は、DsFreeNameResultを使用して割り当てを解除する必要があります。

DS_NAME_RESULT 構造体の配列のインデックスは、各配列要素に含まれるデータを示します。次の定数を使用して、特定のデータの目的のインデックスを指定できます。

DS_ROLE_DOMAIN_OWNER

サーバーはドメインを所有しています。

DS_ROLE_INFRASTRUCTURE_OWNER

サーバーはインフラストラクチャを所有します。

DS_ROLE_PDC_OWNER

サーバーは PDC を所有します。

DS_ROLE_RID_OWNER

サーバーは RID を所有しています。

DS_ROLE_SCHEMA_OWNER

サーバーはスキーマを所有します。

戻り値

関数がロールの一覧を返す場合、戻り値は NO_ERRORです。

関数が失敗した場合、戻り値は次のいずれかのエラーコードになります。

個々の名前変換エラーは、返される DS_NAME_RESULT 構造体で報告されます。

備考

手記

ntdsapi.h ヘッダーは、Unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして DsListRoles を定義します。エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista
サポートされる最小サーバー	Windows Server 2008
ターゲットプラットフォームの	ウィンドウズ
ヘッダー	ntdsapi.h
ライブラリ	Ntdsapi.lib
DLL	Ntdsapi.dll

次の方法で共有