Estrutura RESTOREPOINTINFOA (srrestoreptapi.h)

Artigo
11/20/2024

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 de evento. Esse membro pode ser um dos seguintes valores.

Tipo de evento	Significado
BEGIN_NESTED_SYSTEM_CHANGE 102	Uma alteração do sistema foi iniciada. 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 foi iniciada.
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 seguintes valores.

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 cancela uma instalação.

llSequenceNumber

O número de sequência do ponto de restauração. Para encerrar uma alteração do sistema, defina-a 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.

Observações

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Nenhum com suporte
cabeçalho	srrestoreptapi.h

Consulte também

SRSetRestorePoint

Compartilhar via