Compartilhar via

estrutura TXFS_SAVEPOINT_INFORMATION (winioctl.h)

  • Artigo

[A Microsoft recomenda fortemente que os desenvolvedores utilizem meios alternativos para atender às necessidades do 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, confira Alternativas ao uso do NTFS transacional.]

A estrutura FSCTL_TXFS_SAVEPOINT_INFORMATION especifica a ação a ser executada e em qual transação.

Sintaxe

typedef struct _TXFS_SAVEPOINT_INFORMATION {
  HANDLE KtmTransaction;
  DWORD  ActionCode;
  DWORD  SavepointId;
} TXFS_SAVEPOINT_INFORMATION, *PTXFS_SAVEPOINT_INFORMATION;

Membros

KtmTransaction

Manipule para a transação na qual executar a operação de ponto de salvamento.

ActionCode

Especifica a ação de ponto de salvamento a ser executada. Os valores válidos são:

Valor Significado
TXFS_SAVEPOINT_SET
1 (0x1)
 Cria um novo ponto de salvamento.
TXFS_SAVEPOINT_ROLLBACK
2 (0x2)
 Reverte para o ponto de salvamento especificado pelo membro SavepointId .
TXFS_SAVEPOINT_CLEAR
4 (0x4)
 Limpa o ponto de salvamento definido mais recentemente para a transação especificada.
TXFS_SAVEPOINT_CLEAR_ALL
16 (0x10)
 Limpa todos os pontos de salvamento para a transação.

SavepointId

Se ActionCode for TXFS_SAVEPOINT_SET, na saída, retornará a ID do ponto de salvamento recém-criada.

Se ActionCode for TXFS_ROLLBACK_TO_SAVEPOINT, na entrada, especificará a ID do ponto de salvamento para a qual reverter. Permanece inalterado na saída.

Se ActionCode for TXFS_SAVEPOINT_CLEAR ou TXFS_SAVEPOINT_CLEAR_ALL, esse membro não será usado; portanto, na entrada, especifique NULL.

Requisitos

   
Cliente mínimo com suporte Windows Vista com SP1 [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

FSCTL_TXFS_SAVEPOINT_INFORMATION