Método CVssWriterEx::OnIdentifyEx (vswriter.h)

Devuelve un puntero a un objeto IVssCreateWriterMetadataEx .

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

Sintaxis

bool OnIdentifyEx(
  [in] IVssCreateWriterMetadataEx *pMetadata
);

Parámetros

[in] pMetadata

Puntero a un objeto IVssCreateWriterMetadataEx .

Valor devuelto

Tal como lo implementa la clase base, OnIdentifyEx 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

El método OnIdentifyEx es idéntico al método OnIdentify , salvo que devuelve un puntero de interfaz IVssCreateWriterMetadataEx en lugar de un puntero de interfaz IVssCreateWriterMetadata en el parámetro pMetadata . Un escritor puede invalidar OnIdentify o OnIdentifyEx, pero no ambos.

Los escritores nunca deben producir una excepción de este método o cualquier 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 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 llama a OnIdentifyEx para crear un documento de metadatos de escritor que contenga información sobre los componentes que administra mediante la interfaz IVssCreateWriterMetadataEx .

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, se suele llamar a OnIdentifyEx 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 por sí mismo no forma parte de la secuencia de eventos que componen una secuencia de copia de seguridad o restauración, y el servicio VSS no impide que se generen eventos De identificació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.

Por este motivo, los escritores nunca deben usar su implementación de OnIdentifyEx de cualquiera de las maneras siguientes:

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

Para obtener más información sobre las interacciones del escritor con eventos, consulte Control de eventos de escritor.

Durante los eventos PrepareForBackup, PrepareForSnapshot y PostSnapshot , un escritor puede usar el método GetIdentifyInformation para obtener los metadatos notificados anteriormente por el método OnIdentifyEx del escritor.

El ciclo de vida del objeto IVssCreateWriterMetadataEx al que apunta el parámetro pMetadata está administrado por la infraestructura de VSS.

Requisitos

Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	vswriter.h (incluya Vss.h, VsWriter.h)
Library	VssApi.lib

Consulte también

CVssWriterEx

CVssWriterEx::GetIdentifyInformation

IVssCreateWriterMetadataEx