FSCTL_TXFS_LIST_TRANSACTION_LOCKED_FILES IOCTL (winioctl.h)

  • Artículo

Nota

Microsoft recomienda encarecidamente que los desarrolladores usen medios alternativos para lograr las necesidades de la aplicación. Muchos escenarios para los que se desarrolló TxF se pueden lograr mediante técnicas más sencillas y disponibles. Además, es posible que TxF no esté disponible en versiones futuras de Microsoft Windows. Para obtener más información y alternativas a TxF, consulte Alternativas al uso de NTFS transaccional.

Devuelve una lista de todos los archivos bloqueados actualmente por la transacción especificada. Si el valor devuelto es ERROR_MORE_DATA, devuelve la longitud del búfer necesario para contener la lista completa de archivos en el momento de esta llamada.

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

FSCTL_TXFS_LIST_TRANSACTION_LOCKED_FILES es una operación sincrónica.

Los nombres de ruta de acceso de archivo devueltos son relativos a la raíz del volumen.

El número de archivos devueltos de una llamada a la siguiente puede cambiar según el número de transacciones activas en cualquier momento dado. Si esta llamada devuelve una solicitud de un búfer mayor, ese tamaño puede ser o no adecuado para la siguiente llamada, en función del número de transacciones activas en el momento de la siguiente llamada.

Árbitros: Este código no se admite.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado winioctl.h (incluya Windows.h)

Consulte también