Bagikan melalui

FSCTL_GET_OBJECT_ID IOCTL (winioctl.h)

Mengambil pengidentifikasi objek untuk file atau direktori yang ditentukan.

Untuk melakukan operasi ini, panggil fungsiDeviceIoControldengan parameter berikut.

BOOL DeviceIoControl(
  (HANDLE) hDevice,           // handle to file object
  FSCTL_GET_OBJECT_ID,        // dwIoControlCode
  NULL,                       // lpInBuffer
  0,                          // nInBufferSize
  (LPVOID) lpOutBuffer,       // output buffer
  (DWORD) nOutBufferSize,     // size of output buffer
  (LPDWORD) lpBytesReturned,  // number of bytes returned
  (LPOVERLAPPED) lpOverlapped // OVERLAPPED structure
);

Komentar

Pengidentifikasi objek digunakan untuk melacak file dan direktori. Mereka tidak terlihat oleh sebagian besar aplikasi dan tidak boleh dimodifikasi oleh aplikasi. Memodifikasi pengidentifikasi objek dapat mengakibatkan hilangnya data dari bagian file, hingga dan termasuk seluruh volume data.

Jika tidak ada pengidentifikasi objek yang terkait dengan handel yang ditentukan, tidak ada yang dibuat dan kesalahan dikembalikan. Untuk mengambil pengidentifikasi objek yang ada atau menghasilkannya jika tidak ada pengidentifikasi objek yang ada dalam satu langkah, gunakan FSCTL_CREATE_OR_GET_OBJECT_ID. Untuk menetapkan pengidentifikasi objek secara manual, gunakan FSCTL_SET_OBJECT_ID.

Di Windows 8 dan Windows Server 2012, kode ini didukung oleh teknologi berikut.

Teknologi Didukung
Protokol Server Message Block (SMB) 3.0 Ya
Failover Transparan (TFO) SMB 3.0 Ya
SMB 3.0 dengan Scale-out File Shares (SO) Ya
Sistem File Volume Bersama Kluster (CsvFS) Ya
Sistem File Tangguh (ReFS) Tidak.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Header winioctl.h (termasuk Windows.h)

Lihat juga