DFS_INFO_6 構造体 (lmdfs.h)

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

分散ファイルシステム (DFS) のルートまたはリンクに関する情報が含まれます。この構造体には、名前、状態、 GUID、タイムアウト、名前空間/ルート/リンクプロパティ、メタデータサイズ、ターゲットの数、ルートまたはリンクの各ターゲットに関する情報が含まれます。この構造体は、 NetDfsEnum、 NetDfsGetClientInfo、および NetDfsGetInfo 関数でのみ使用されます。

ターゲット情報を含まない DFS 名前空間に関する情報を取得するには、代わりに DFS_INFO_5 を使用します。

構文

typedef struct _DFS_INFO_6 {
  LPWSTR               EntryPath;
  LPWSTR               Comment;
  DWORD                State;
  ULONG                Timeout;
  GUID                 Guid;
  ULONG                PropertyFlags;
  ULONG                MetadataSize;
  DWORD                NumberOfStorages;
#if ...
  LPDFS_STORAGE_INFO_1 Storage;
#else
  LPDFS_STORAGE_INFO_1 Storage;
#endif
} DFS_INFO_6, *PDFS_INFO_6, *LPDFS_INFO_6;

メンバー

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 でサイトコストが有効になっている場合、応答には複数のグループを含めることができます。各グループには、紹介を要求する特定の 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 ルートに対してのみ有効です。

NumberOfStorages

DFS ルートまたはリンクのターゲットの数を指定します。これらのターゲットは、この構造体の Storage メンバーに含まれています。

Storage

DFS ターゲット情報を含む DFS_STORAGE_INFO_1 構造体の配列を指定します。

注釈

サーバーターゲットの優先度の決定方法の詳細については、「 DFS サーバーターゲットの優先順位付け」を参照してください。

要件

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