Bagikan melalui

FSCTL_GET_OBJECT_ID IOCTL (winioctl.h)

  • Artikel

Mengambil pengidentifikasi objek untuk file atau direktori yang ditentukan.

Untuk melakukan operasi ini, panggil fungsi DeviceIoControl dengan parameter berikut.

BOOL DeviceIoControl(
  (HANDLE) hDevice,           // handle to device
  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
);

Keterangan

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 membuat pengidentifikasi objek, gunakan FSCTL_SET_OBJECT_ID. 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.

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

Teknologi Didukung
Protokol Server Message Block (SMB) 3.0 Ya
SMB 3.0 Transparent Failover (TFO) Ya
SMB 3.0 dengan Berbagi File Peluasan Skala (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