FSCTL_SET_OBJECT_ID IOCTL (winioctl.h)
指定したファイルまたはディレクトリのオブジェクト識別子を設定します。
この操作を実行するには、次のパラメーターを使用して DeviceIoControl 関数を呼び出します。
BOOL DeviceIoControl(
(HANDLE) hDevice, // handle to device
FSCTL_SET_OBJECT_ID, // 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
);
解説
オブジェクト識別子は、ファイルとディレクトリを追跡するために使用されます。 ほとんどのアプリケーションでは見えず、アプリケーションによって変更されるべきではありません。 オブジェクト識別子を変更すると、ファイルの一部から、データのボリューム全体までのデータが失われる可能性があります。
オブジェクト識別子を指定した値に明示的に設定するには、この操作を使用します。 既にオブジェクト識別子を持つオブジェクトに対してオブジェクト識別子を設定しようとすると失敗します。 ボリュームで既に使用されているオブジェクト識別子の使用も失敗します。 FSCTL_CREATE_OR_GET_OBJECT_ID操作を使用して、オブジェクトがまだ存在しない場合に NTFS ファイル システムにオブジェクト識別子を生成させます。
リモート ファイルのタイム スタンプが正しく更新されない場合があることに注意してください。 一貫性のある結果を得るには、バッファーなしの I/O を使用します。
Windows 8 および Windows Server 2012 では、このコードは次のテクノロジでサポートされています。
テクノロジ | サポートされています |
---|---|
サーバー メッセージ ブロック (SMB) 3.0 プロトコル | はい |
SMB 3.0 Transparent Failover (TFO) | はい |
スケールアウト ファイル共有 (SO) を使う SMB 3.0 | はい |
クラスターの共有ボリューム ファイル システム (CsvFS) | はい |
Resilient File System (ReFS) | いいえ |
要件
サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
Header | winioctl.h (Windows.h を含む) |