DOMAIN_CONTROLLER_INFOA構造体 (dsgetdc.h)

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

DOMAIN_CONTROLLER_INFO 構造体は、ドメインコントローラーに関するデータを受信するために、DsGetDcName 関数と共に使用されます。

構文

typedef struct _DOMAIN_CONTROLLER_INFOA {
  LPSTR DomainControllerName;
  LPSTR DomainControllerAddress;
  ULONG DomainControllerAddressType;
  GUID  DomainGuid;
  LPSTR DomainName;
  LPSTR DnsForestName;
  ULONG Flags;
  LPSTR DcSiteName;
  LPSTR ClientSiteName;
} DOMAIN_CONTROLLER_INFOA, *PDOMAIN_CONTROLLER_INFOA;

メンバーズ

DomainControllerName

検出されたドメインコントローラーのコンピューター名を指定する null で終わる文字列へのポインター。返されたコンピューター名の先頭に "\" が付いています。 DNS スタイルの名前 ("\phoenix.fabrikam.com" など) が返されます (使用可能な場合)。 DNS スタイルの名前を使用できない場合は、フラットスタイルの名前 ("\phoenix" など) が返されます。この例は、ドメインが Windows NT 4.0 ドメインの場合、またはドメインがプロトコルの IP ファミリをサポートしていない場合に適用されます。

DomainControllerAddress

検出されたドメインコントローラーのアドレスを指定する null で終わる文字列へのポインター。アドレスの先頭に "\" が付いています。この文字列は、DomainControllerAddressType メンバーによって定義されている型の 1 つです。

DomainControllerAddressType

DomainControllerAddress メンバーに含まれる文字列の種類を示します。次のいずれかの値を指定できます。

DS_INET_ADDRESS

アドレスは、ドメインコントローラーの文字列 IP アドレス ("\157.55.94.74" など) です。

DS_NETBIOS_ADDRESS

アドレスは、ドメインコントローラーの NetBIOS 名 ("\phoenix" など) です。

DomainGuid

ドメインの GUID。ドメインコントローラーにドメイン GUID がない場合、このメンバーは 0 です。たとえば、ドメインコントローラーは Windows 2000 ドメインコントローラーではありません。

DomainName

ドメインの名前を指定する null で終わる文字列へのポインター。 DNS スタイルの名前 (例: "fabrikam.com") が返されます (使用可能な場合)。それ以外の場合は、"fabrikam" などのフラットスタイルの名前が返されます。ドメイン名が変更されている場合、この名前は要求されたドメイン名とは異なる場合があります。

DnsForestName

DS ツリーのルートにあるドメインの名前を指定する null で終わる文字列へのポインター。 DNS スタイルの名前 (例: "fabrikam.com") が返されます (使用可能な場合)。それ以外の場合は、フラットスタイルの名前 ("fabrikam" など) が返されます。

Flags

ドメインコントローラーを記述するフラグのセットが含まれています。 0 または次の値の 1 つ以上の組み合わせを指定できます。

DS_DNS_CONTROLLER_FLAG

DomainControllerName メンバーは DNS 形式です。

DS_DNS_DOMAIN_FLAG

DomainName メンバーは DNS 形式です。

DS_DNS_FOREST_FLAG

DnsForestName メンバーは DNS 形式です。

DS_CLOSEST_FLAG

ドメインコントローラーは、クライアントと同じサイトにあります。

DS_DS_FLAG

ドメインコントローラーは、ドメインのディレクトリサービスサーバーです。

DS_FULL_SECRET_DOMAIN_6_FLAG

ドメインコントローラーは、Windows 2008 以降の書き込み可能なドメインコントローラーです。

DS_GOOD_TIMESERV_FLAG

ドメインコントローラーは、ドメインに対して信頼性の高い Windows タイムサービスを実行しています。

DS_GC_FLAG

ドメインコントローラーは、DnsForestNameで指定されたフォレストのグローバルカタログサーバーです。

DS_KDC_FLAG

ドメインコントローラーは、ドメインの Kerberos キー配布センターです。

DS_LDAP_FLAG

サーバーは LDAP サーバーです。

DS_NDNC_FLAG

ドメイン名は、アプリケーション (ドメイン以外) の名前付けコンテキストです。

DS_PDC_FLAG

ドメインコントローラーは、ドメインのプライマリドメインコントローラーです。

DS_SELECT_SECRET_DOMAIN_6_FLAG

ドメインコントローラーは、Windows 2008 以降の読み取り専用ドメインコントローラーです。

DS_TIMESERV_FLAG

ドメインコントローラーは、ドメインの Windows タイムサービスを実行しています。

DS_WRITABLE_FLAG

ドメインコントローラーは、書き込み可能なディレクトリサービス (または SAM) をホストします。

DcSiteName

ドメインコントローラーが配置されているサイトの名前を指定する null で終わる文字列へのポインター。ドメインコントローラーがサイトに存在しない場合、このメンバーは NULL 可能性があります。たとえば、ドメインコントローラーは Windows NT 4.0 ドメインコントローラーです。

ClientSiteName

コンピューターが属するサイトの名前を指定する null で終わる文字列へのポインター。コンピューターは、DsGetDcNameに渡される ComputerName パラメーターで指定されます。コンピューターを含むサイトが見つからない場合、このメンバーは NULL 可能性があります。たとえば、DS 管理者が、コンピューターが存在するサブネットを有効なサイトに関連付けられていない場合などです。

備考

手記

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

必要条件

要件	価値
サポートされる最小クライアント	Windows Vista
サポートされる最小サーバー	Windows Server 2008
ヘッダー	dsgetdc.h

次の方法で共有