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
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 |