Método IVssWMComponent::GetFile (vsbackup.h)

El método GetFile obtiene un descriptor de archivo asociado a un grupo de archivos.

Sintaxis

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

Parámetros

[in] iFile

Desplazamiento entre 0 y n-1, donde n es el número de archivos del grupo de archivos según lo especificado por el miembro cFileCount del objeto VSS_COMPONENTINFO devuelto por IVssWMComponent::GetComponentInfo.

[out] ppFiledesc

Puntero indirecto doble a un objeto IVssWMFiledesc que contiene la información de descriptor de archivo devuelta.

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 instancia de la 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, consulte Control de eventos y errores en VSS.
VSS_E_OBJECT_NOT_FOUND	El archivo especificado 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, 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

El autor de la llamada es responsable de llamar a IUnknown::Release para liberar los recursos del sistema mantenidos por el 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

IVssWMComponent