次の方法で共有

DsListInfoForServerA 関数 (ntdsapi.h)

  • [アーティクル]

DsListInfoForServer 関数は、サーバーのその他のデータを一覧表示します。

構文

NTDSAPI DWORD DsListInfoForServerA(
  [in]  HANDLE           hDs,
  [in]  LPCSTR           server,
  [out] PDS_NAME_RESULTA *ppInfo
);

パラメーター

[in] hDs

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

[in] server

サーバー名を指定する null で終わる文字列へのポインター。 この名前は、DsListServersForDomainInSite または dsListServersInSite 関数 返される文字列のいずれかと同じである必要があります。

[out] ppInfo

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

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

DS_LIST_ACCOUNT_OBJECT_FOR_SERVER

ドメイン コントローラー (DC) のアカウント オブジェクトの名前。

DS_LIST_DNS_HOST_NAME_FOR_SERVER

DC の DNS ホスト名。

DS_LIST_DSA_OBJECT_FOR_SERVER

ドメイン コントローラー (DC) のディレクトリ サービス エージェント (DSA) の GUID。

戻り値

関数がサーバー データを返す場合、戻り値は NO_ERROR。

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

備考

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

手記

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

必要条件

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

関連項目

DS_NAME_RESULT

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

DsFreeNameResult の