DFS_INFO_8 構造体 (lmdfs.h)
ルートまたはリンクの名前、状態、 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
or
\\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 を含む) |