FSCTL_GET_OBJECT_ID IOCTL (winioctl.h)

  • Artículo

Recupera el identificador de objeto del archivo o directorio especificados.

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

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

Comentarios

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 las deben modificar 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 hasta volúmenes completos de datos.

Si no hay ningún identificador de objeto asociado al identificador especificado, no se crea ninguno y se devuelve un error. Para crear un identificador de objeto, use FSCTL_SET_OBJECT_ID. Para recuperar un identificador de objeto existente o generar uno si no hay ningún identificador de objeto existente en un paso, use FSCTL_CREATE_OR_GET_OBJECT_ID.

En Windows 8 y Windows Server 2012, este código es compatible con las siguientes tecnologías.

Tecnología Compatible
Protocolo Bloque de mensajes del servidor (SMB) 3.0 Sí
Conmutación por error transparente (TFO) de SMB 3.0 Sí
SMB 3.0 con recursos compartidos de archivos de escalabilidad horizontal (SO) Sí
Sistema de archivos de Volumen compartido de clúster (CsvFS) Sí
Sistema de archivos resistente a errores (ReFS) No

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado winioctl.h (incluye Windows.h)

Consulte también