FSCTL_CREATE_OR_GET_OBJECT_ID IOCTL (winioctl.h)

Извлекает идентификатор объекта для указанного файла или каталога. Если идентификатор объекта не существует, при использовании FSCTL_CREATE_OR_GET_OBJECT_ID создается.

Чтобы выполнить эту операцию, вызовите функциюDeviceIoControlсо следующими параметрами.

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

Замечания

Идентификаторы объектов используются для отслеживания файлов и каталогов. Они невидимы для большинства приложений и никогда не должны изменяться приложениями. Изменение идентификатора объекта может привести к потере данных из частей файла до целых томов данных.

Эта операция создает идентификатор объекта, если объект еще не имеет. Чтобы проверить наличие идентификатора объекта и извлечь его, если он существует, используйте операцию FSCTL_GET_OBJECT_ID . Чтобы вручную назначить идентификатор объекта, используйте операцию FSCTL_SET_OBJECT_ID .

В Windows Server 2012 эта функция поддерживается следующими технологиями.

Требования

См. также

• DeviceIoControl (Управление устройством)
• FILE_OBJECTID_BUFFER
• FSCTL_DELETE_OBJECT_ID
• FSCTL_GET_OBJECT_ID
• FSCTL_SET_OBJECT_ID
• FSCTL_SET_OBJECT_ID_EXTENDED
• идентификаторы объектов