FSCTL_CREATE_USN_JOURNAL IOCTL (winioctl.h)
ターゲット ボリュームに更新シーケンス番号 (USN) 変更ジャーナル ストリームを作成するか、既存の変更ジャーナル ストリームを変更します。
C++ |
---|
BOOL WINAPI DeviceIoControl( (HANDLE) hDevice, // handle to volume FSCTL_CREATE_USN_JOURNAL, // dwIoControlCode(LPVOID) lpInBuffer, // input buffer (DWORD) nInBufferSize, // size of input buffer NULL, // lpOutBuffer 0, // nOutBufferSize(LPDWORD) lpBytesReturned, // number of bytes returned (LPOVERLAPPED) lpOverlapped ); // OVERLAPPED structure |
備考
この操作での重複した I/O の影響については、「DeviceIoControl」トピックの「解説」セクションを参照してください。
FSCTL_CREATE_USN_JOURNAL を使用して、ボリュームの新しい変更ジャーナル ストリームを作成できます。 ストリームの作成後、NTFS ファイル システムはそのボリュームの変更履歴を保持します。
FSCTL_CREATE_USN_JOURNAL を使用して、既存の変更ジャーナル ストリームを変更することもできます。 変更ジャーナル・ストリームが既に存在する場合は、FSCTL_CREATE_USN_JOURNALCREATE_USN_JOURNAL_DATA 構造体に指定された特性に設定されます。 変更ジャーナル ストリームは最終的に大きくなるか、CREATE_USN_JOURNAL_DATA が課す新しいサイズ制限にトリミングされます。
詳細については、「変更履歴の作成、変更、および削除の
ボリュームへのハンドルを取得するには、
\\.\X:
上記の文字列では、X は、ボリュームが表示されるドライブを識別する文字です。 ボリュームは NTFS 3.0 以降である必要があります。 ボリュームの NTFS バージョンを取得するには、管理者アクセス権を持つコマンド プロンプトを開き、次のコマンドを実行します。
fsutil fsinfo ntfsinfo X:
ここで、X はボリュームのドライブ文字です。
Windows Server 2012 では、この関数は次のテクノロジでサポートされています。
テクノロジー | サポート |
---|---|
サーバー メッセージ ブロック (SMB) 3.0 プロトコル | いいえ |
SMB 3.0 透過的フェールオーバー (TFO) | いいえ |
SMB 3.0 とスケールアウト ファイル共有 (SO) | いいえ |
クラスター共有ボリューム ファイル システム (CsvFS) | はい |
必要条件
要件 | 価値 |
---|---|
サポートされる最小クライアント | Windows XP [デスクトップ アプリのみ] |
サポートされる最小サーバー | Windows Server 2003 [デスクトップ アプリのみ] |
ヘッダー | winioctl.h (Windows.h を含む) |
関連項目
CreateFile の
DeviceIoControl の
重複する を
ボリューム管理コントロール コード を