DFS_INFO_105 構造体 (lmdfs.h)

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

プロパティフラグで指定されたコメント、状態、タイムアウト、DFS 動作など、DFS ルートまたはリンクに関する情報が含まれます。この構造体は、 NetDfsSetInfo 関数でのみ使用されます。

構文

typedef struct _DFS_INFO_105 {
  LPWSTR Comment;
  DWORD  State;
  ULONG  Timeout;
  ULONG  PropertyFlagMask;
  ULONG  PropertyFlags;
} DFS_INFO_105, *PDFS_INFO_105, *LPDFS_INFO_105;

メンバー

Comment

DFS ルートまたはリンクに関連付けられたコメントを含む null で終わる Unicode 文字列へのポインター。

State

DFS ルートまたはリンクの状態を記述するビットフラグのセットを指定します。DFS 名前空間ルートの状態を変更できません。 1 つの DFS_VOLUME_STATE フラグが設定され、1 つの DFS_VOLUME_FLAVOR フラグが設定されます。これらのフラグの解釈について説明する例については、 DFS_INFO_2の「解説」セクションを参照してください。

既定値 (0x00000000)

既存の状態を維持します。

DFS_VOLUME_STATE_OK (0x00000001)

指定した DFS ルートまたはリンクが通常の状態です。

DFS_VOLUME_STATE_OFFLINE (0x00000003)

指定された DFS ルートまたはリンクがオフラインであるか、使用できません。

DFS_VOLUME_STATE_ONLINE (0x00000004)

指定した DFS ルートまたはリンクを使用できます。

Timeout

DFS ルートまたはリンクのタイムアウトを秒単位で指定します。

PropertyFlagMask

PropertyFlags フィールドで評価に有効なフラグを示すマスク値を指定します。

PropertyFlags

ビットフィールド。各ビットは、実際のプロパティに応じて、DFS 名前空間全体、DFS ルート、または個々の DFS リンクに適用できる特定のプロパティを担当します。特に指定がない限り、ビットの任意の組み合わせが許可されます。

DFS_PROPERTY_FLAG_INSITE_REFERRALS (0x00000001)

参照を要求するクライアントと同じサイト内のターゲットのみを含む DFS ルートまたはリンクに対する DFS サーバーからの紹介応答。 2 つのグローバル優先度クラスのターゲットは、サイトの場所に関係なく、常に返されます。このフラグは、ドメインベースの DFS ルート、スタンドアロンルート、およびリンクに適用されます。このフラグが DFS ルートで設定されている場合は、すべてのリンクに適用されます。それ以外の場合は、個々のリンクに適用されます。リンクでの設定は、ルート設定をオーバーライドしません。

DFS_PROPERTY_FLAG_ROOT_SCALABILITY (0x00000002)

このフラグが設定されている場合、DFS サーバーはプライマリドメインコントローラー (PDC) ではなく、最も近いドメインコントローラー (DC) をポーリングして、その名前空間の DFS 名前空間の変更をチェックします。 DFS サーバーによる DFS メタデータの変更は、このフラグによって制御されませんが、PDC に自動的に送信されます。このフラグは名前空間全体に適用され、ドメインベースの DFS 名前空間に対してのみ有効です。

DFS_PROPERTY_FLAG_SITE_COSTING (0x00000004)

ターゲットの Active Directory サイトのコストを有効にするには、このフラグを設定します。 DFS サーバーから要求元の DFS クライアントに返されるターゲットは、DFS クライアントに関してサイト間コストでグループ化されます。グループは、クライアントと同じサイト内のターゲットで構成される最初のグループでサイトコストを増やすという点で順序付けられます。各グループ内のターゲットはランダムに並べ替えます。

このフラグが有効になっていない場合、既定の戻り値は 2 つのセットです。クライアントと同じサイト内のターゲットのセットと、残りのすべてのターゲットの 1 つのセットです。このフラグは DFS 名前空間全体に適用され、ドメインベースの DFS 名前空間とスタンドアロン DFS 名前空間の両方に対して有効です。

ターゲットの優先順位は、ターゲットの順序にさらに影響を与える可能性があります。サイトコストを使用してターゲットに優先順位を付ける方法の詳細については、「 DFS サーバーターゲットの優先順位付け」を参照してください。

DFS_PROPERTY_FLAG_TARGET_FAILBACK (0x00000008)

このフラグを設定して、V4 DFS クライアントがより最適な (低コスト以上の優先順位) ターゲットにフェールバックできるようにします。このフラグが DFS ルートで設定されている場合は、すべてのリンクに適用されます。それ以外の場合は、個々のリンクに適用されます。個々のリンク設定は、ルート設定をオーバーライドしません。ターゲットフェールバック設定は、DFS サーバーによる V4 紹介応答で DFS クライアントに提供されます。このフラグは、ドメインベースの 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 リンクに関連付けるには、このフラグを有効にする必要があります。

要件


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

次の方法で共有