Método IVssExamineWriterMetadata::GetExcludeFile (vsbackup.h)

  • Artículo

El método GetExcludeFile obtiene información sobre los archivos que se han excluido explícitamente de la copia de seguridad de un escritor determinado.

Sintaxis

HRESULT GetExcludeFile(
  [in]  UINT           iFile,
  [out] IVssWMFiledesc **ppFiledesc
);

Parámetros

[in] iFile

Índice de un conjunto de archivos excluidos. El valor de este parámetro es un entero comprendido entre 0 y n-1, donde n es el número total de conjuntos de archivos excluidos explícitamente de los componentes de un sistema de escritura determinado. IVssExamineWriterMetadata::GetFileCounts devuelve el valor de n.

[out] ppFiledesc

Puntero indirecto doblemente a un objeto IVssWMFiledesc que contiene la información del elemento de archivo.

Valor devuelto

A continuación se muestran los códigos de retorno válidos para este método.

Valor Significado
S_OK
 Devolvió correctamente un puntero a una interfaz IVssWMFiledesc .
E_INVALIDARG
 Uno de los valores de parámetro no es válido.
E_OUTOFMEMORY
 El autor de la llamada no tiene memoria u otros recursos del sistema.
VSS_E_INVALID_XML_DOCUMENT
 El documento XML no es válido. Compruebe el registro de eventos para obtener más información. Para obtener más información, vea Control de eventos y errores en VSS.
VSS_E_OBJECT_NOT_FOUND
 El conjunto de archivos especificado para la exclusión no existe.
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, vea 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 obtener más información sobre la exclusión de archivos, vea Exclude File List Specification.

El autor de la llamada es responsable de llamar a IUnknown::Release para liberar los recursos del objeto IVssWMFiledesc devuelto.

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

Consulte también

IVssExamineWriterMetadata

IVssExamineWriterMetadata::GetFileCounts