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

Un escritor llama al método OnIdentify después de recibir un evento Identify .

OnIdentify es un método virtual. Se implementa mediante la clase base CVssWriter , pero se puede invalidar mediante clases derivadas.

Sintaxis

bool OnIdentify(
  [in] IVssCreateWriterMetadata *pMetadata
);

Parámetros

[in] pMetadata

Puntero a un objeto IVssCreateWriterMetadata utilizado para construir los metadatos del escritor.

Valor devuelto

Tal como lo implementa la clase base, OnIdentify siempre devuelve true.

Cualquier otra implementación de este método debe devolver true , excepto en el caso de un error irrecuperable. Si se produce un error irrecuperable, el método debe devolver false.

En todos los casos en los que se produce un error, incluidos los errores nofatales, el método debe escribir una entrada detallada en el registro de eventos para notificar el motivo exacto del error.

Comentarios

La implementación predeterminada de este método por la clase base CVssWriter devuelve true sin realizar ninguna otra operación.

Los escritores nunca deben iniciar una excepción de este método ni de ningún otro CVssWriter(Ex)::OnXxx método de devolución de llamada.

Los escritores nunca deben llamar al método CVssWriter::SetWriterFailure desde el método OnIdentify o CVssWriterEx::OnIdentifyEx .

Si este método llama al método CVssWriterEx2::GetSessionId , debe hacerlo en el mismo subproceso que llamó a este método. Para obtener más información, vea Writer Event Handling.

En respuesta a un evento Identify generado por otra aplicación, un escritor usa el controlador OnIdentify para crear un documento de metadatos de escritor que contenga información sobre los componentes que administra mediante la interfaz IVssCreateWriterMetadata .

La aplicación que generó el evento Identify recupera el documento de metadatos del escritor y examina la información del componente del escritor mediante la interfaz IVssExamineWriterMetadata .

Se requiere un evento De identificación antes de los eventos que componen una secuencia de copia de seguridad o restauración. Por lo tanto, OnIdentify suele invocarse para controlar un evento Identify en respuesta a la llamada de un solicitante a IVssBackupComponents::GatherWriterMetadata como parte de una operación de copia de seguridad o restauración.

Sin embargo, un evento Identify no forma parte de la secuencia de eventos que constituye una copia de seguridad o restauración y el servicio VSS no impide su generación, incluso mientras una secuencia de copia de seguridad o restauración está en curso. Por ejemplo, las aplicaciones de administración de VSS usan el evento Identify para determinar y mostrar el estado de los escritores en el sistema.

Este es el caso, los escritores nunca deben usar su implementación de OnIdentify de las siguientes maneras:

• Como principio de su control de una copia de seguridad o restauración
• Para establecer o mantener información sobre el estado del escritor

Consulte Writer Event Handling (Control de eventos de escritor ) para obtener más información sobre las interacciones del escritor con eventos.

El ciclo de vida del objeto IVssCreateWriterMetadata pasado a OnIdentify se administra mediante la infraestructura de VSS.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	vswriter.h (incluye Vss.h, VsWriter.h)
Library	VssApi.lib

Consulte también

CVssWriter

IVssBackupComponents::GatherWriterMetadata

IVssCreateWriterMetadata