FSCTL_CREATE_OR_GET_OBJECT_ID IOCTL (winioctl.h)

Recupera el identificador de objeto del archivo o directorio especificados. Si no existe ningún identificador de objeto, el uso de FSCTL_CREATE_OR_GET_OBJECT_ID crea uno.

Para realizar esta operación, llame a la función DeviceIoControl con los parámetros siguientes.

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
);

Observaciones

Los identificadores de objeto se usan para realizar un seguimiento de archivos y directorios. Son invisibles para la mayoría de las aplicaciones y nunca deben ser modificadas por las aplicaciones. La modificación de un identificador de objeto puede dar lugar a la pérdida de datos de partes de un archivo, hasta y incluyendo volúmenes completos de datos.

Esta operación crea un identificador de objeto si el objeto aún no tiene uno. Para probar la presencia de un identificador de objeto y recuperarlo si existe, use la operación FSCTL_GET_OBJECT_ID . Para asignar manualmente un identificador de objeto, use la operación FSCTL_SET_OBJECT_ID .

En Windows Server 2012, esta función es compatible con las siguientes tecnologías.

Requisitos

Consulte también

• DeviceIoControl
• FILE_OBJECTID_BUFFER
• FSCTL_DELETE_OBJECT_ID
• FSCTL_GET_OBJECT_ID
• FSCTL_SET_OBJECT_ID
• FSCTL_SET_OBJECT_ID_EXTENDED
• Identificadores de objeto