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 |
|---|---|
|
Se devolvió correctamente el puntero a una interfaz IVssWMFiledesc . |
|
Uno de los valores de parámetro no es válido. |
|
El autor de la llamada no tiene memoria u otros recursos del sistema. |
|
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 |