DFS_INFO_8 構造体 (lmdfs.h)

[アーティクル]
03/11/2023

ルートまたはリンクの名前、状態、 GUID、タイムアウト、プロパティフラグ、メタデータサイズ、DFS ターゲット情報、およびリンク再解析ポイントセキュリティ記述子が含まれます。この構造体は、 NetDfsGetInfo 関数と NetDfsEnum 関数でのみ使用されます。

構文

typedef struct _DFS_INFO_8 {
  LPWSTR               EntryPath;
  LPWSTR               Comment;
  DWORD                State;
  ULONG                Timeout;
  GUID                 Guid;
  ULONG                PropertyFlags;
  ULONG                MetadataSize;
  ULONG                SecurityDescriptorLength;
#if ...
  PUCHAR               pSecurityDescriptor;
  ULONG                SdLengthReserved;
#else
  PSECURITY_DESCRIPTOR pSecurityDescriptor;
#endif
  DWORD                NumberOfStorages;
} DFS_INFO_8, *PDFS_INFO_8, *LPDFS_INFO_8;

メンバー

EntryPath

DFS ルートまたはリンクの汎用名前付け規則 (UNC) パスを指定する null で終わる Unicode 文字列へのポインター。

リンクの場合、文字列は 2 つの形式のいずれかで指定できます。最初の形式は次のとおりです。

\\Servername\DfsName\link_path

ここで 、ServerName はスタンドアロン DFS 名前空間をホストするルートターゲットサーバーの名前です。 DfsName は DFS 名前空間の名前です。と link_path は DFS リンクです。

2 番目の形式は次のとおりです。

\\Domainname\DomDfsname\link_path

ここで 、DomainName はドメインベースの DFS 名前空間をホストするドメインの名前です。 DomDfsname は DFS 名前空間の名前です。と link_path は DFS リンクです。

ルートの場合、文字列は次の 2 つの形式のいずれかで指定できます。

\\Servername\DfsName

\\Domainname\DomDfsname

ここで、名前の値は前に説明したものと同じです。

Comment

DFS ルートまたはリンクに関連付けられたコメントを含む null で終わる Unicode 文字列へのポインター。

State

DFS ルートまたはリンクを記述するビットフラグのセットを指定します。 1 つの DFS_VOLUME_STATE フラグが設定され、1 つの DFS_VOLUME_FLAVOR フラグが設定されます。 DFS_VOLUME_FLAVORS ビットマスク (0x00000300) を使用して DFS 名前空間のフレーバーを抽出し、DFS_VOLUME_STATESビットマスク (0x0000000F) を使用して、このメンバーから DFS ルートまたはリンクの状態を抽出する必要があります。フラグの解釈について説明する例については、 DFS_INFO_2の「解説」セクションを参照してください。

DFS_VOLUME_STATE_OK (0x00000001)

指定した DFS ルートまたはリンクが通常の状態です。

DFS_VOLUME_STATE_INCONSISTENT (0x00000002)

内部 DFS データベースは、指定された DFS ルートまたはリンクと矛盾しています。不整合を修復しようとしましたが、失敗しました。

DFS_VOLUME_STATE_OFFLINE (0x00000003)

指定された DFS ルートまたはリンクがオフラインであるか、使用できません。

DFS_VOLUME_STATE_ONLINE (0x00000004)

指定した DFS ルートまたはリンクを使用できます。

DFS_VOLUME_FLAVOR_STANDALONE (0x00000100)

ルートがスタンドアロン DFS 名前空間に関連付けられている場合、システムはこのフラグを設定します。

DFS_VOLUME_FLAVOR_AD_BLOB (0x00000200)

ルートがドメインベースの DFS 名前空間に関連付けられている場合、システムはこのフラグを設定します。

Timeout

DFS ルートまたはリンクのタイムアウトを秒単位で指定します。

Guid

DFS ルートまたはリンクの GUID を 指定します。

PropertyFlags

DFS 名前空間、ルート、またはリンクの特定のプロパティを記述するフラグのセットを指定します。

DFS_PROPERTY_FLAG_INSITE_REFERRALS (0x00000001)

スコープ: ドメインルート、スタンドアロンルート、およびリンク。このフラグが DFS ルートで設定されている場合は、すべてのリンクに適用されます。それ以外の場合、このフラグの値は個々のリンクごとに考慮されます。

このフラグが設定されている場合、DFS ルートまたは "INSITE" オプションが有効になっているリンクに対する DFS サーバーからの DFS 紹介応答には、紹介を要求する DFS クライアントと同じサイトにあるターゲットのみが含まれます。 2 つのグローバル優先度クラスのターゲットは、サイトの場所に関係なく、常に返されます。

DFS_PROPERTY_FLAG_ROOT_SCALABILITY (0x00000002)

スコープ: ドメインベースの DFS 名前空間のみの DFS 名前空間全体。

既定では、DFS ルートターゲットサーバーは PDS をポーリングして、DFS メタデータへの変更を検出します。 PDC でのサーバーの負荷を防ぐために、DFS 名前空間に対してルートスケーラビリティを有効にすることができます。このフラグを設定すると、DFS サーバーは共通名前空間の DFS メタデータの変更について PDC ではなく、最も近いドメインコントローラーをポーリングします。ただし、メタデータに加えられた変更は、PDC で引き続き行う必要があることに注意してください。

DFS_PROPERTY_FLAG_SITE_COSTING (0x00000004)

スコープ: ドメインベースの DFS 名前空間とスタンドアロン DFS 名前空間の両方の DFS 名前空間全体。

既定では、DFS ルートまたはリンクの DFS サーバーから DFS クライアントへの紹介応答で返されるターゲットは、クライアントと同じサイト内のターゲットとサイト外のターゲットの 2 つのグループで構成されます。

Active Directory に対してサイトコストが有効になっている場合、応答には 2 つ以上のグループを含めることができます。各グループには、紹介を要求する特定の DFS クライアントに対して同じサイトコストのターゲットが含まれます。グループは、サイトコストを増やすことで順序付けされます。サイトコストを使用してターゲットに優先順位を付ける方法の詳細については、「 DFS サーバーターゲットの優先順位付け」を参照してください。

DFS_PROPERTY_FLAG_TARGET_FAILBACK (0x00000008)

スコープ: ドメインベースの DFS ルート、スタンドアロン DFS ルート、および DFS リンク。このフラグが DFS ルートで設定されている場合は、すべてのリンクに適用されます。それ以外の場合、このフラグの値は個々のリンクごとに考慮されます。

このフラグを設定すると、V4 DFS クライアントに対して最適なターゲットフェールバックが有効になり、最適でないターゲットにフェールオーバーした後に最適なターゲットにフェールバックできるようになります。ターゲットフェールバック設定は、DFS サーバーによる V4 紹介応答で DFS クライアントに提供されます。

DFS_PROPERTY_FLAG_CLUSTER_ENABLED (0x00000010)

スコープ: スタンドアロン DFS ルートとリンクのみ。

DFS ルートは、記憶域フェールオーバーの高可用性を提供するためにクラスター化されます。このフラグは、 NetDfsSetInfo 関数を使用して設定することはできません。

DFS_PROPERTY_FLAG_ABDE (0x00000020)

スコープ: ドメインベースの DFS ルートとスタンドアロン DFS ルート。

このフラグを設定すると、DFS 名前空間の DFS ルートターゲット共有全体で、Access-Based ディレクトリ列挙 (ABDE) モードのサポートが有効になります。このフラグは、 DFS_NAMESPACE_CAPABILITY_ABDE 機能フラグが設定されている DFS 名前空間に対してのみ有効です。詳細については、「 DFS_INFO_50 と DFS_SUPPORTED_NAMESPACE_VERSION_INFO」を参照してください。

DFS_PROPERTY_FLAG_ABDE フラグは DFS 名前空間ルートでのみ有効であり、ルートターゲット、リンク、またはリンクターゲットでは有効ではありません。セキュリティ記述子を DFS リンクに関連付けるには、このフラグを有効にする必要があります。

MetadataSize

ドメインベースの DFS 名前空間の場合、このメンバーは対応する Active Directory データ BLOB のサイズをバイト単位で指定します。スタンドアロン DFS 名前空間の場合、このフィールドは、関連付けられている特定のデータ項目に加えて、キー名と値名など、レジストリに格納されているメタデータのサイズを指定します。

このフィールドは、DFS ルートに対してのみ有効です。

SecurityDescriptorLength

pSecurityDescriptor

DFS リンクの再解析ポイントに関連付けられる自己相対セキュリティ記述子を指定するSECURITY_DESCRIPTOR構造体へのポインター。このフィールドは DFS リンクに対してのみ有効です。

SdLengthReserved

このメンバーは、システム使用のために予約されています。

NumberOfStorages

DFS ルートまたはリンクを含むボリュームの記憶域サーバーの数を指定します。

要件


サポートされている最小のクライアント	Windows Vista SP1
サポートされている最小のサーバー	Windows Server 2008
Header	lmdfs.h (LmDfs.h、Lm.h を含む)