DFS_INFO_9構造体 (lmdfs.h)
名前、状態、 GUID、タイムアウト、プロパティ フラグ、メタデータ サイズ、DFS ターゲット情報、リンク再解析ポイントセキュリティ記述子、ルートまたはリンクの DFS ターゲットの一覧が含まれます。 この構造体は、 NetDfsGetInfo 関数と NetDfsEnum 関数でのみ使用されます。
構文
typedef struct _DFS_INFO_9 {
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;
#if ...
LPDFS_STORAGE_INFO_1 Storage;
#else
LPDFS_STORAGE_INFO_1 Storage;
#endif
} DFS_INFO_9, *PDFS_INFO_9, *LPDFS_INFO_9;
メンバー
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 ルートに対してのみ有効です。
SecurityDescriptorLength
pSecurityDescriptor
DFS リンクの再 解析ポイントに関連付ける自己相対セキュリティ記述子を指定するSECURITY_DESCRIPTOR構造体へのポインター。 このフィールドは DFS リンクに対してのみ有効です。
SdLengthReserved
このメンバーは、システム使用のために予約されています。
NumberOfStorages
DFS ルートまたはリンクのターゲットの数を指定します。 これらのターゲットは、この構造体の Storage メンバーに含まれています。
Storage
DFS ターゲット情報を含む DFS_STORAGE_INFO_1 構造体の配列を指定します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista SP1 |
| サポートされている最小のサーバー | Windows Server 2008 |
| Header | lmdfs.h (LmDfs.h、Lm.h を含む) |
こちらもご覧ください
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示