DFS_INFO_4 構造体 (lmdfs.h)
分散ファイル システム (DFS) のルートまたはリンクに関する情報が含まれます。 この構造体には、名前、状態、 GUID、タイムアウト、ターゲットの数、ルートまたはリンクの各ターゲットに関する情報が含まれます。 この構造体は、 NetDfsEnum、 NetDfsGetClientInfo、 NetDfsGetInfo 関数、 およびFSCTL_DFS_GET_PKT_ENTRY_STATE コントロール コードでのみ使用されます。
構文
typedef struct _DFS_INFO_4 {
LPWSTR EntryPath;
LPWSTR Comment;
DWORD State;
ULONG Timeout;
GUID Guid;
DWORD NumberOfStorages;
#if ...
LPDFS_STORAGE_INFO Storage;
#else
LPDFS_STORAGE_INFO Storage;
#endif
} DFS_INFO_4, *PDFS_INFO_4, *LPDFS_INFO_4;
メンバー
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 ルートまたはリンク状態を抽出するには、DFS_VOLUME_STATES ビットマスク (0x0000000F) を使用する必要があります。 フラグの解釈について説明する例については、 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 を指定します。
NumberOfStorages
DFS ターゲットの数を指定します。
Storage
DFS_STORAGE_INFO構造体の配列へのポインター。 NumberOfStorages メンバーは、配列内の構造体の数を指定します。
注釈
DFS_INFO_4構造体には、DFS ターゲットごとに 1 つ、1 つ以上のDFS_STORAGE_INFO構造体が含まれています。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| Header | lmdfs.h (LmDfs.h、Lm.h を含む) |