Compartilhar via

Estrutura RESTOREPOINTINFOA (srrestoreptapi.h)

  • Artigo

Contém informações usadas pela função SRSetRestorePoint .

Sintaxe

typedef struct _RESTOREPTINFOA {
  DWORD dwEventType;
  DWORD dwRestorePtType;
  INT64 llSequenceNumber;
  CHAR  szDescription[MAX_DESC];
} RESTOREPOINTINFOA, *PRESTOREPOINTINFOA;

Membros

dwEventType

O tipo do evento. Esse membro pode ser um dos valores a seguir.

Tipo de evento Significado
BEGIN_NESTED_SYSTEM_CHANGE
102
 Uma alteração do sistema começou. Uma chamada aninhada subsequente não cria um novo ponto de restauração.

As chamadas subsequentes devem usar END_NESTED_SYSTEM_CHANGE, não END_SYSTEM_CHANGE.
BEGIN_SYSTEM_CHANGE
100
 Uma alteração do sistema começou.
END_NESTED_SYSTEM_CHANGE
103
 Uma alteração do sistema terminou.
END_SYSTEM_CHANGE
101
 Uma alteração do sistema terminou.

dwRestorePtType

O tipo de ponto de restauração. Esse membro pode ser um dos valores a seguir.

Tipo de ponto de restauração Significado
APPLICATION_INSTALL
0
 Um aplicativo foi instalado.
APPLICATION_UNINSTALL
1
 Um aplicativo foi desinstalado.
DEVICE_DRIVER_INSTALL
10
 Um driver de dispositivo foi instalado.
MODIFY_SETTINGS
12
 Um aplicativo teve recursos adicionados ou removidos.
CANCELLED_OPERATION
13
 Um aplicativo precisa excluir o ponto de restauração que ele criou. Por exemplo, um aplicativo usaria esse sinalizador quando um usuário cancelasse uma instalação.

llSequenceNumber

O número de sequência do ponto de restauração. Para encerrar uma alteração do sistema, defina isso como o número de sequência retornado pela chamada anterior para SRSetRestorePoint.

szDescription[MAX_DESC]

A descrição a ser exibida para que o usuário possa identificar facilmente um ponto de restauração. O comprimento máximo de uma cadeia de caracteres ANSI é MAX_DESC. O comprimento máximo de uma cadeia de caracteres Unicode é MAX_DESC_W. Para obter mais informações, consulte Texto de descrição do ponto de restauração.

Comentários

Observação

O cabeçalho srrestoreptapi.h define RESTOREPOINTINFO como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Nenhum compatível
Cabeçalho srrestoreptapi.h

Confira também

SRSetRestorePoint