Método CVssWriter::OnIdentify (vswriter.h)

  • Artigo

O método OnIdentify é chamado por um gravador após o recebimento de um evento Identifi .

OnIdentify é um método virtual. Ele é implementado pela classe base CVssWriter , mas pode ser substituído por classes derivadas.

Sintaxe

bool OnIdentify(
  [in] IVssCreateWriterMetadata *pMetadata
);

Parâmetros

[in] pMetadata

Um ponteiro para um objeto IVssCreateWriterMetadata usado para construir os metadados do gravador.

Retornar valor

Conforme implementado pela classe base, OnIdentify sempre retorna true.

Qualquer outra implementação desse método deve retornar true , exceto no caso de um erro fatal. Se ocorrer um erro fatal, o método deverá retornar false.

Em todos os casos em que ocorre uma falha, incluindo erros não virtuais, o método deve gravar uma entrada detalhada no log de eventos para relatar o motivo exato da falha.

Comentários

A implementação padrão desse método pela classe base CVssWriter retorna true sem executar nenhuma outra operação.

Os gravadores nunca devem gerar uma exceção desse método ou de qualquer outro método de retorno de chamada CVssWriter(Ex)::OnXxx .

Os gravadores nunca devem chamar o método CVssWriter::SetWriterFailure do método OnIdentify ou CVssWriterEx::OnIdentifyEx .

Se esse método chamar o método CVssWriterEx2::GetSessionId , ele deverá fazer isso no mesmo thread que chamou esse método. Para obter mais informações, consulte Tratamento de eventos do gravador.

Em resposta a um evento Identifique gerado por outro aplicativo, um gravador usa o manipulador OnIdentify para criar um Documento de Metadados do Gravador contendo informações sobre os componentes que ele gerencia usando a interface IVssCreateWriterMetadata .

O aplicativo que gerou o evento Identifi recupera o Documento de Metadados do Gravador e examina as informações de componente do gravador usando a interface IVssExamineWriterMetadata .

Um evento Identifi é necessário antes dos eventos que compõem uma sequência de backup ou restauração. Portanto, OnIdentify é geralmente invocado para lidar com um evento Identifi em resposta à chamada de um solicitante para IVssBackupComponents::GatherWriterMetadata como parte de uma operação de backup ou restauração.

No entanto, um evento Identifi não faz parte da sequência de eventos que compõem um backup ou restauração e o serviço VSS não impede sua geração, mesmo quando uma sequência de backup ou restauração está em andamento. Por exemplo, os aplicativos de gerenciamento do VSS usam o evento Identifi para determinar e exibir o estado dos gravadores no sistema.

Sendo assim, os gravadores nunca devem usar a implementação do OnIdentify das seguintes maneiras:

  • Como o início de sua manipulação de um backup ou restauração
  • Para definir ou manter informações sobre o estado do gravador
Consulte Tratamento de Eventos do Gravador para obter mais informações sobre interações do gravador com eventos.

O ciclo de vida do objeto IVssCreateWriterMetadata passado para OnIdentify é gerenciado pela infraestrutura do VSS.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho vswriter.h (inclua Vss.h, VsWriter.h)
Biblioteca VssApi.lib

Confira também

CVssWriter

IVssBackupComponents::GatherWriterMetadata

IVssCreateWriterMetadata