FSCTL_TXFS_QUERY_RM_INFORMATION IOCTL (winioctl.h)

  • Artículo

Nota

Microsoft recomienda encarecidamente a los desarrolladores usar 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.

Recupera información de un administrador de recursos (RM).

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

BOOL DeviceIoControl(
  (HANDLE) hDevice,                 // handle to device
  FSCTL_TXFS_QUERY_RM_INFORMATION,  // dwIoControlCode
  NULL,                             // lpInBuffer
  0,                                // nInBufferSize
  (LPVOID) lpOutBuffer,             // output buffer
  (DWORD) nOutBufferSize,           // size of output buffer
  (LPDWORD) lpBytesReturned,        // bytes returned
  (LPOVERLAPPED) lpOverlapped       // OVERLAPPED structure
);

Comentarios

FSCTL_TXFS_QUERY_RM_INFORMATION es una operación sincrónica.

Si se produce un error en esta llamada con ERROR_BUFFER_TOO_SMALL, el miembro BytesRequired de la estructura TXFS_QUERY_RM_INFORMATION especifica el tamaño que debe tener el búfer para que la llamada se devuelva correctamente.

Si va a escribir una aplicación que admita clientes remotos del protocolo de bloque de mensajes del servidor, debe usar este código de control para usar el administrador de recursos.

Se puede consultar el administrador de recursos independientemente de su estado; Si no se inicia rm, se devuelve ERROR_RM_NOT_ACTIVE . Puede usar la información sobre el intervalo activo del registro para guiar las decisiones sobre la cantidad del registro que se va a archivar.

Á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 (incluye Windows.h)

Consulte también