DFS_INFO_5 構造体 (lmdfs.h)
分散ファイル システム (DFS) のルートまたはリンクに関する情報が含まれます。 この構造体には、名前、状態、 GUID、タイムアウト、名前空間/ルート/リンク プロパティ、メタデータ サイズ、ルートまたはリンクのターゲットの数が含まれます。 この構造体は、 NetDfsEnum、 NetDfsGetClientInfo、および NetDfsGetInfo 関数でのみ使用されます。
DFS 名前空間のターゲットに関する情報を取得するには、代わりに DFS_INFO_6 を使用します。
構文
typedef struct _DFS_INFO_5 {
LPWSTR EntryPath;
LPWSTR Comment;
DWORD State;
ULONG Timeout;
GUID Guid;
ULONG PropertyFlags;
ULONG MetadataSize;
DWORD NumberOfStorages;
} DFS_INFO_5, *PDFS_INFO_5, *LPDFS_INFO_5;
メンバー
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
or
\\Domainname\DomDfsname
ここで、名前の値は前に説明したものと同じです。
Comment
DFS ルートまたはリンクに関連付けられたコメントを含む null で終わる Unicode 文字列へのポインター。
State
DFS ルートまたはリンクを記述するビット フラグのセットを指定します。 1 つの DFS_VOLUME_STATE フラグが設定され、1 つの DFS_VOLUME_FLAVOR フラグが設定されます。 フラグの解釈を説明する例については、 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_PROPERTY_FLAG_ROOT_SCALABILITY (0x00000002)
DFS 名前空間の変更に対する PDC の代わりに、最も近いドメイン コントローラーがポーリングされます。 このフラグは、ドメイン ルートに対してのみ有効です。
DFS_PROPERTY_FLAG_SITE_COSTING (0x00000004)
ターゲットの Active Directory サイト のコスト計算が有効になっており、ターゲットを DFS クライアントからターゲットに増やすサイト コストのセットにグループ化します。 各セットには、同じコストのターゲットがあります。 このフラグは、ドメインおよびスタンドアロン ルートに対してのみ有効です。
DFS_PROPERTY_FLAG_TARGET_FAILBACK (0x00000008)
DFS クライアントは、最適でないターゲットにフェールオーバーした後、使用可能な近いターゲットにフェールバックします。 このフラグは、ドメインとスタンドアロンのルートとリンクの両方に対して有効です。
DFS_PROPERTY_FLAG_CLUSTER_ENABLED (0x00000010)
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 ルートまたはリンクのターゲットの数を指定します。
解説
ターゲットとターゲットの優先順位に関する情報を取得するには、 DFS_INFO_6 構造体を使用します。 DFS_INFO_5 は、ターゲット情報なしで DFS 名前空間に関する情報を指定するために使用されます。
要件
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008、Windows Server 2008 |
| Header | lmdfs.h (LmDfs.h、Lm.h を含む) |