Bagikan melalui

FSCTL_CREATE_OR_GET_OBJECT_ID IOCTL (winioctl.h)

  • Artikel

Mengambil pengidentifikasi objek untuk file atau direktori yang ditentukan. Jika tidak ada pengidentifikasi objek, menggunakan FSCTL_CREATE_OR_GET_OBJECT_ID membuatnya.

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

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

Operasi ini membuat pengidentifikasi objek jika objek belum memilikinya. Untuk menguji keberadaan pengidentifikasi objek, dan mengambilnya jika ada, gunakan operasi FSCTL_GET_OBJECT_ID . Untuk membuat pengidentifikasi objek tanpa terlebih dahulu menguji keberadaannya, gunakan operasi FSCTL_SET_OBJECT_ID .

Di Windows Server 2012, fungsi 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 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