Método IVssExamineWriterMetadata::GetExcludeFile (vsbackup.h)
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 |
|---|---|
|
Devolvió correctamente un 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. |
|
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. |
|
El conjunto de archivos especificado para la exclusión no existe. |
|
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 |