FSCTL_TXFS_LIST_TRANSACTIONS 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.

Retorna uma lista de todas as transações atualmente envolvidas no gerenciador de recursos especificado. Se a função falhar com ERROR_MORE_DATA, ela retornará o comprimento do buffer necessário para manter a lista completa de transações no momento dessa chamada.

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

Comentários

FSCTL_TXFS_LIST_TRANSACTIONS é uma operação síncrona.

O número de transações retornadas de uma chamada para a próxima pode mudar dependendo do número de transações ativas em um determinado ponto no tempo. Se essa chamada retornar uma solicitação para um buffer maior, esse tamanho poderá ou não ser adequado para a próxima chamada, com base no número de transações ativas no momento da próxima chamada.

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

Requisitos

   
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