Método IVssExamineWriterMetadataEx2::GetExcludeFromSnapshotFile (vsbackup.h)

Obtiene información sobre los conjuntos de archivos que se han excluido explícitamente de una instantánea determinada.

Sintaxis

HRESULT GetExcludeFromSnapshotFile(
  [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 inclusive, donde n es el número total de conjuntos de archivos excluidos explícitamente de una instantánea determinada. El valor de n lo devuelve el método IVssExamineWriterMetadataEx2::GetExcludeFromSnapshotCount .

[out] ppFiledesc

Puntero doblemente indirecto 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	Se devolvió correctamente el 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_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

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

El método GetExcludeFromSnapshotFile está pensado para informar sobre los conjuntos de archivos excluidos de una instantánea. Los solicitantes no deben excluir archivos de la copia de seguridad en función de la información devuelta por este método.

Requisitos

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

Consulte también

IVssCreateWriterMetadataEx::AddExcludeFilesFromSnapshot

IVssExamineWriterMetadataEx2

IVssExamineWriterMetadataEx2::GetExcludeFromSnapshotCount