Metodo IVssWMComponent::GetDatabaseFile (vsbackup.h)

Il metodo GetDatabaseFile ottiene un oggetto IVssWMFiledesc contenente informazioni sul file del componente di backup del database specificato.

Sintassi

HRESULT GetDatabaseFile(
  [in]  UINT           iDBFile,
  [out] IVssWMFiledesc **ppFiledesc
);

[in] iDBFile

Offset compreso tra 0 e n-1, dove n è il numero di file di database come specificato dal membro cDatabases dell'oggetto VSS_COMPONENTINFO restituito da IVssWMComponent::GetComponentInfo.

[out] ppFiledesc

Puntatore indiretto doubly a un oggetto IVssWMFiledesc contenente le informazioni sul descrittore di file restituito.

Di seguito sono riportati i codici restituiti validi per questo metodo.

Valore	Significato
S_OK	È stato restituito un puntatore a un'istanza dell'interfaccia IVssWMFiledesc .
E_INVALIDARG	Uno dei valori dei parametri non è valido.
E_OUTOFMEMORY	Il chiamante non è in memoria o altre risorse di sistema.
VSS_E_INVALID_XML_DOCUMENT	Il documento XML non è valido. Controllare il registro eventi per informazioni dettagliate. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS.
VSS_E_OBJECT_NOT_FOUND	Il file di database specificato non esiste.
VSS_E_UNEXPECTED	Errore imprevisto. Il codice di errore viene registrato nel file di log degli errori. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS. Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo valore non è supportato fino a Windows Server 2008 R2 e Windows 7. E_UNEXPECTED viene invece usato.

Il chiamante è responsabile della chiamata a IUnknown::Release per rilasciare le risorse di sistema mantenute dall'oggetto IVssWMFiledesc restituito.

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vsbackup.h (include VsBackup.h, Vss.h, VsWriter.h)
Libreria	VssApi.lib