Compartilhar via

FSCTL_TXFS_QUERY_RM_INFORMATION IOCTL (winioctl.h)

  • Artigo

Observação

A Microsoft recomenda fortemente que os desenvolvedores utilizem meios alternativos para atender às necessidades do seu aplicativo. Muitos cenários para os quais o TxF foi desenvolvido podem ser obtidos por meio de técnicas mais simples e prontamente disponíveis. Além disso, o TxF pode não estar disponível em versões futuras do Microsoft Windows. Para obter mais informações e alternativas ao TxF, consulte Alternativas ao uso do NTFS transacional.

Recupera informações de um RM (gerenciador de recursos).

Para executar essa operação, chame a função DeviceIoControl com os parâmetros a seguir.

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

Comentários

FSCTL_TXFS_QUERY_RM_INFORMATION é uma operação síncrona.

Se essa chamada falhar com ERROR_BUFFER_TOO_SMALL, o membro BytesRequired da estrutura TXFS_QUERY_RM_INFORMATION especificará o tamanho do buffer para que a chamada retorne com êxito.

Se você estiver escrevendo um aplicativo que dê suporte a clientes remotos do Protocolo de Bloqueio de Mensagens do Servidor, deverá usar esse código de controle para usar o gerenciador de recursos.

O gerenciador de recursos pode ser consultado independentemente de seu estado; se o RM não for iniciado, ERROR_RM_NOT_ACTIVE será retornado. Você pode usar as informações sobre o intervalo ativo do log para orientar as decisões sobre quanto do log deve ser arquivado.

Refs: Não há suporte para esse código.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho winioctl.h (inclua Windows.h)

Confira também