次の方法で共有

CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT構造体 (ntifs.h)

  • [アーティクル]

CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT 構造体には、クラスター共有ボリューム (CSV) ファイル システムに送信できる追加の create パラメーター (ECP) コンテキストが含まれています。これにより、このオープン時に到着する IO を処理する方法のプロパティを設定できます。

構文

typedef struct _CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT {
  SIZE_T Size;
  ULONG  PauseTimeoutInSeconds;
  ULONG  Flags;
} CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT, *PCSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT;

メンバーズ

Size

この構造体のサイズ (バイト単位)。

PauseTimeoutInSeconds

CSV ボリュームが一時停止した場合に、このファイル オブジェクトに対して発行された IO を保留中の状態で保持できる秒数。 期限が切れると、CSV は、このファイル オブジェクトに対して発行されたすべての IO を状態STATUS_CSV_IO_PAUSE_TIMEOUTで完了します。 このメンバーには、次のいずれかの値を指定できます。

価値 意味
0xFFFFFFFF タイムアウトがないことを示し、既定の動作が要求されます。
0 CSV は IO を一時停止せず、IO をすぐに完了します。
その他の値 CSV は、他のすべての値を 10 秒の倍数に切り上げ、この値をタイムアウトとして使用します。 サポートされる最大タイムアウト値は 30 分です。 指定された値が 30 分を超える場合、CSV は値を最大値に自動的に設定します。

Flags

set プロパティ フラグ。 このメンバーには、次のフラグのビットごとの OR を指定できます。

旗 意味
CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT_FLAGS_VALID_ONLY_IF_CSV_COORDINATOR 開いているこのファイルは、調整ノードでのみ有効である必要があることを CSVFS に指示します。 オープンが CSVFS に送られ、ノードが調整ノードでない場合、オープンは失敗します。 ファイルが開き、調整ノードが移動されると、開いているファイルは無効になります。 このフラグは、ファイルが CSVFS で直接開かれている場合にのみ使用され、SMB 経由でファイルが開かれた場合は無視されます。

Flags の下位 16 ビットは、CSV で認識されない場合にSTATUS_INVALID_PARAMETERで作成が失敗するフラグ用です。 上位 16 ビットは、CSVFS がそれらを処理する方法を知らない場合に自動的に無視されるフラグ用です。

備考

システム定義GUID_ECP_CSV_SET_HANDLE_PROPERTIES値は、FltAllocateExtraCreateParameter や fsRtlRemoveExtraCreateParameterなどの ECP 関連のサポート ルーチンを呼び出すときに、この ECP コンテキスト構造で使用されます。

詳細については、「追加の作成パラメーター の概要」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows 8
ヘッダー ntifs.h