DOMAIN_CONTROLLER_INFOA構造体 (dsgetdc.h)

[アーティクル]
08/23/2023

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 ヘッダーは、DOMAIN_CONTROLLER_INFOをエイリアスとして定義します。これは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択します。 encoding-neutral エイリアスの使用を encoding-neutral ではないコードと混在すると、コンパイルエラーまたはランタイムエラーが発生する不一致が発生する可能性があります。詳細については、「関数プロトタイプの規則」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
Header	dsgetdc.h

こちらもご覧ください

ディレクトリサービス構造

DsGetDcName