DsListRolesA 関数 (ntdsapi.h)

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

構文

NTDSAPI DWORD DsListRolesA(
  [in]  HANDLE           hDs,
  [out] PDS_NAME_RESULTA *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 ヘッダーは、DSListRoles をエイリアスとして定義し、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

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

こちらもご覧ください

DS_NAME_RESULT

ドメイン コントローラーとレプリケーション管理機能

DsFreeNameResult