FSCTL_READ_USN_JOURNAL IOCTL (winioctl.h)

[アーティクル]
03/13/2024

指定した 2 つの USN 値間の更新シーケンス番号 (USN) 変更ジャーナルレコードのセットを取得します。

C++
BOOL WINAPI DeviceIoControl( (HANDLE) hDevice, // handle to volume (DWORD) FSCTL_READ_USN_JOURNAL, // dwIoControlCode (LPVOID) lpInBuffer, // input buffer (DWORD) nInBufferSize, // size of input buffer (LPVOID) lpOutBuffer, // output buffer (DWORD) nOutBufferSize, // size of output buffer (LPDWORD) lpBytesReturned, // number of bytes returned (LPOVERLAPPED) lpOverlapped ); // OVERLAPPED structure

C++

BOOL 
WINAPI 
DeviceIoControl( (HANDLE)       hDevice,         // handle to volume
                 (DWORD) FSCTL_READ_USN_JOURNAL, // dwIoControlCode
                 (LPVOID)       lpInBuffer,      // input buffer
                 (DWORD)        nInBufferSize,   // size of input buffer
                 (LPVOID)       lpOutBuffer,     // output buffer
                 (DWORD)        nOutBufferSize,  // size of output buffer
                 (LPDWORD)      lpBytesReturned, // number of bytes returned
                 (LPOVERLAPPED) lpOverlapped );  // OVERLAPPED structure

注釈

この操作に対する重複した I/O の影響については、 DeviceIoControl トピックの「解説」セクションを参照してください。

USN レコードを返す DeviceIoControl コントロールコードには、 FSCTL_READ_USN_JOURNAL と FSCTL_ENUM_USN_DATAの 2 つがあります。 2 つの USN 間の USN レコードの一覧 (列挙) が必要な場合は、後者を使用します。 USN で選択する場合は、前者を使用します。

詳細については、「変更ジャーナルの作成、変更、および削除」を参照してください。

ボリュームへのハンドルを取得するには、 lpFileName パラメーターを次の形式の文字列に設定して CreateFile を呼び出します。

\.\X:

前の文字列では、 X はボリュームが表示されるドライブを識別する文字です。ボリュームは NTFS である必要があります。

Windows 8とWindows Server 2012では、このコードは次のテクノロジでサポートされています。

テクノロジ	サポートされています
サーバーメッセージブロック (SMB) 3.0 プロトコル	いいえ
SMB 3.0 Transparent Failover (TFO)	いいえ
スケールアウトファイル共有 (SO) を使う SMB 3.0	いいえ
クラスターの共有ボリュームファイルシステム (CsvFS)	コメントを表示する

アプリケーションで CsvFs の一時停止/再開で誤検知が発生する可能性があります。

例

例については、「変更ジャーナルレコードのバッファーのウォーク」を参照してください。

要件

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップアプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
Header	winioctl.h (Windows.h を含む)