Función CreateVssExamineWriterMetadata (vsbackup.h)

La función CreateVssExamineWriterMetadata crea un objeto IVssExamineWriterMetadata .

Nota Esta función se exporta como CreateVssExamineWriterMetadataInternal, pero debe llamar a CreateVssExamineWriterMetadata, no CreateVssExamineWriterMetadataInternal.

 

Sintaxis

HRESULT CreateVssExamineWriterMetadata(
  [in]  BSTR                      bstrXML,
  [out] IVssExamineWriterMetadata **ppMetadata
);

Parámetros

[in] bstrXML

Cadena XML que contiene un documento de metadatos de escritor con el que inicializar el objeto IVssExamineWriterMetadata devuelto.

[out] ppMetadata

Variable que recibe un puntero de interfaz IVssExamineWriterMetadata al objeto .

Valor devuelto

Los valores devueltos que se enumeran aquí son además de los HRESULT COM normales que se pueden devolver en cualquier momento desde la función.

Value	Significado
S_OK	Devolvió correctamente un puntero a una interfaz IVssExamineWriterMetadata .
E_ACCESSDENIED	El autor de la llamada no tiene suficientes privilegios de copia de seguridad o no es administrador.
E_INVALIDARG	Uno de los parámetros no es válido.
E_OUTOFMEMORY	Memoria insuficiente u otros recursos del sistema.
VSS_E_INVALID_XML_DOCUMENT	El documento XML pasado en el parámetro bstrXML no es válido; es decir, no es una cadena XML formada correctamente o no coincide con el esquema.
VSS_E_UNEXPECTED	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

Para guardar una copia del documento de metadatos del escritor en una cadena XML para pasar el parámetro bstrXML , use el método IVssExamineWriterMetadata::SaveAsXML .

Para recuperar la versión más reciente del documento de metadatos del escritor, use el método IVssBackupComponents::GetWriterMetadata .

Para cargar un documento de metadatos de escritor en un objeto IVssExamineWriterMetadata existente, use el método IVssExamineWriterMetadata::LoadFromXML .

Los usuarios no deben intentar modificar el contenido del documento de metadatos del escritor.

La aplicación de llamada es responsable de llamar a IUnknown::Release para liberar los recursos mantenidos por el objeto IVssExamineWriterMetadata cuando el objeto ya no es necesario.

Requisitos

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	vsbackup.h (incluya VsBackup.h, Vss.h, VsWriter.h)
Library	VssApi.lib
Archivo DLL	VssApi.dll

Consulte también

IVssExamineWriterMetadata