Método IVssBackupComponentsEx::GetWriterMetadataEx (vsbackup.h)
El método GetWriterMetadataEx devuelve los metadatos de una instancia de escritor específica que se ejecuta en el sistema.
Sintaxis
HRESULT GetWriterMetadataEx(
[in] UINT iWriter,
[out] VSS_ID *pidInstance,
[out] IVssExamineWriterMetadataEx **ppMetadata
);
Parámetros
[in] iWriter
Índice del escritor cuyos metadatos se van a recuperar. El valor de este parámetro es un entero comprendido entre 0 y n-1, donde n es el número total de escritores del sistema actual. El valor de n lo devuelve el método IVssBackupComponents::GetWriterMetadataCount .
[out] pidInstance
Dirección de una variable asignada por el autor de la llamada que recibe el identificador de instancia del escritor que recopiló los metadatos.
[out] ppMetadata
Puntero indirecto doblemente a la instancia del objeto IVssExamineWriterMetadataEx que contiene los metadatos devueltos.
Valor devuelto
A continuación se muestran los códigos de retorno válidos para este método.
| Valor | Significado |
|---|---|
|
Se devolvió correctamente un puntero a un objeto de interfaz IVssExamineWriterMetadataEx . |
|
Uno de los valores de parámetro no es válido. |
|
El autor de la llamada no tiene memoria u otros recursos del sistema. |
|
El objeto de componentes de copia de seguridad no se inicializa, se ha llamado a este método durante una operación de restauración o no se ha llamado a este método dentro de la secuencia correcta. |
|
El documento XML no es válido. Compruebe el registro de eventos para obtener más información. Para obtener más información, consulte Control de eventos y errores en VSS. |
|
El parámetro iWriter no apunta a un escritor válido. |
|
error inesperado. El código de error se registra en el archivo de registro de errores. Para obtener más información, consulte Control de eventos y errores en VSS.
Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: Este valor no se admite hasta Windows Server 2008 R2 y Windows 7. E_UNEXPECTED se usa en su lugar. |
Comentarios
GetWriterMetadataEx es idéntico al método IVssBackupComponents::GetWriterMetadata , salvo que devuelve un puntero de interfaz IVssExamineWriterMetadataEx en lugar de un puntero de interfaz IVssExamineWriterMetadata en el parámetro ppMetadata .
Un solicitante debe llamar al método IVssBackupComponents::GatherWriterMetadata asincrónico y esperar a que se complete antes de llamar a GetWriterMetadataEx.
Aunque se debe llamar al método GatherWriterMetadata antes de una operación de restauración o copia de seguridad, no se suele llamar a GetWriterMetadataEx para las restauraciones.
Información de componente recuperada (durante las operaciones de copia de seguridad) mediante el método IVssExamineWriterMetadata::GetComponent , donde la interfaz IVssExamineWriterMetadataEx ha sido devuelta por GetWriterMetadataEx, procede del documento de metadatos del escritor de un proceso de escritura en directo.
Esto contrasta con la información devuelta por GetWriterComponents (durante las operaciones de restauración), que se almacenó en el documento de componentes de copia de seguridad mediante llamadas al método IVssBackupComponents::AddComponent .
Cuando el autor de la llamada de este método termine de acceder a los metadatos, debe llamar a IUnknown::Release.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008, Windows Server 2003 con SP1 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | vsbackup.h (incluya VsBackup.h, Vss.h, VsWriter.h) |
| Library | VssApi.lib |