FSCTL_GET_RETRIEVAL_POINTERS IOCTL (winioctl.h)

  • Artículo

Dado un identificador de archivo, recupera una estructura de datos que describe la asignación y la ubicación en el disco de un archivo específico, o bien, dado un identificador de volumen, las ubicaciones de clústeres incorrectos en un volumen.

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

DeviceIoControl(
  (HANDLE) hDevice,                 // handle to file, directory, or volume
  FSCTL_GET_RETRIEVAL_POINTERS,     // dwIoControlCode
  (LPVOID) lpInBuffer,              // input buffer
  (DWORD) nInBufferSize,            // size of input buffer
  (LPVOID) lpOutBuffer,             // output buffer
  (DWORD) nOutBufferSize,           // size of output buffer
  (LPDWORD) lpBytesReturned,        // number of bytes returned
  (LPOVERLAPPED) lpOverlapped       // OVERLAPPED structure
);

Comentarios

La operación de FSCTL_GET_RETRIEVAL_POINTERS recupera una estructura de datos de tamaño variable que describe la asignación y la ubicación en el disco de un archivo específico. La estructura describe la asignación entre números de clúster virtual (desplazamientos de VCN dentro del espacio de secuencia o archivo) y números de clúster lógicos (desplazamientos de LCN dentro del espacio de volumen).

El código de control de FSCTL_GET_RETRIEVAL_POINTERS es compatible con las operaciones de archivos o directorios en sistemas de archivos NTFS, FAT, exFAT, UDF y ReFS.

En los sistemas de archivos admitidos, la operación FSCTL_GET_RETRIEVAL_POINTERS devuelve las ubicaciones de extensión de los datos noident. Los datos residentes nunca tienen ubicaciones de extensión.

El código de control FSCTL_GET_RETRIEVAL_POINTERS también admite la funcionalidad alternativa de buscar clústeres incorrectos. Para consultar las ubicaciones de clústeres incorrectos en un volumen con formato NTFS, FAT o exFAT, use un identificador de volumen como parámetro hDevice . Esta funcionalidad solo se admite en NTFS, FAT y exFAT, y el autor de la llamada debe tener MANAGE_VOLUME_ACCESS permiso para el volumen.

Para conocer las implicaciones de la E/S superpuesta en esta operación, consulte la sección Comentarios del tema DeviceIoControl .

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 No
Conmutación por error transparente (TFO) de SMB 3.0 No
SMB 3.0 con recursos compartidos de archivos de escalabilidad horizontal (SO) No
Sistema de archivos de Volumen compartido de clúster (CsvFS) Sí

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