DFS_INFO_107 構造体 (lmdfs.h)

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

コメント、状態、タイムアウト、プロパティフラグ、リンク再解析ポイントセキュリティ記述子など、DFS ルートまたはリンクに関する情報が含まれます。この構造体は、 NetDfsGetInfo 関数と NetDfsSetInfo 関数でのみ使用されます。

構文

typedef struct _DFS_INFO_107 {
  LPWSTR               Comment;
  DWORD                State;
  ULONG                Timeout;
  ULONG                PropertyFlagMask;
  ULONG                PropertyFlags;
  ULONG                SecurityDescriptorLength;
#if ...
  PUCHAR               pSecurityDescriptor;
  ULONG                SdLengthReserved;
#else
  PSECURITY_DESCRIPTOR pSecurityDescriptor;
#endif
} DFS_INFO_107, *PDFS_INFO_107, *LPDFS_INFO_107;

メンバー

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 ルートまたはリンクのタイムアウトを秒単位で指定します。

PropertyFlagMask

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

PropertyFlags

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

DFS_PROPERTY_FLAG_INSITE_REFERRALS (0x00000001)

参照を要求するクライアントと同じサイト内のターゲットのみを含む DFS ルートまたはリンクに対する DFS サーバーからの紹介応答。 2 つのグローバル優先度クラスのターゲットは、サイトの場所に関係なく、常に返されます。このフラグは、ドメインベースの DFS ルート、スタンドアロン DFS ルート、および 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_PROPERTY_FLAG_CLUSTER_ENABLED (0x00000010)

このフラグを設定すると、DFS ルートがクラスター化され、記憶域フェールオーバーの高可用性が提供されます。このフラグは NetDfsSetInfo 関数を使用して設定できず、スタンドアロンの DFS ルートとリンクにのみ適用されます。

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 リンクに関連付けるには、このフラグを有効にする必要があります。

SecurityDescriptorLength

pSecurityDescriptor

DFS リンクの再解析ポイントに関連付けられる自己相対セキュリティ記述子を指定するSECURITY_DESCRIPTOR構造体へのポインター。このフィールドは DFS リンクに対してのみ有効です。

SdLengthReserved

このメンバーは、システム使用のために予約されています。

要件

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

こちらもご覧ください

分散ファイルシステム関数

NetDfsSetInfo