Metodo IVssBackupComponents::GetWriterMetadata (vsbackup.h)

Articolo
03/03/2024

Il metodo GetWriterMetadata restituisce i metadati per un writer specifico in esecuzione nel sistema.

Sintassi

HRESULT GetWriterMetadata(
  [in]  UINT                      iWriter,
  [out] VSS_ID                    *pidInstance,
  [out] IVssExamineWriterMetadata **ppMetadata
);

Parametri

[in] iWriter

Indice del writer i cui metadati devono essere recuperati. Il valore di questo parametro è un intero compreso tra 0 e n-1, dove n è il numero totale di writer nel sistema corrente. Il valore di n viene restituito da IVssBackupComponents::GetWriterMetadataCount.

[out] pidInstance

Puntatore all'identificatore dell'istanza del writer che ha raccolto i metadati.

[out] ppMetadata

Puntatore indiretto doubly all'istanza dell'oggetto IVssExamineWriterMetadata che contiene i metadati restituiti.

Valore restituito

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

Valore	Significato
S_OK	È stato restituito un puntatore a un oggetto interfaccia IVssExamineWriterMetadata .
E_INVALIDARG	Uno dei valori dei parametri non è valido.
E_OUTOFMEMORY	Il chiamante non è in memoria o altre risorse di sistema.
VSS_E_BAD_STATE	L'oggetto componenti di backup non viene inizializzato, questo metodo è stato chiamato durante un'operazione di ripristino o questo metodo non è stato chiamato all'interno della sequenza corretta.
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	La copia shadow specificata 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.

Commenti

Un richiedente deve chiamare l'operazione asincrona IVssBackupComponents::GatherWriterMetadata e attendere il completamento prima di chiamare GetWriterMetadata.

Anche se IVssBackupComponents::GatherWriterMetadata deve essere chiamato prima di un'operazione di ripristino o di backup, GetWriterMetadata non viene in genere chiamato per i ripristini.

Le informazioni sui componenti recuperate (durante le operazioni di backup) usando IVssExamineWriterMetadata::GetComponent, dove l'interfaccia IVssExamineWriterMetadata è stata restituita da GetWriterMetadata, proviene dal documento metadati writer di un processo di writer live.

In contrasto con le informazioni restituite da GetWriterComponents (durante le operazioni di ripristino), archiviate nel documento Componenti di backup tramite chiamate a AddComponent.

Al termine dell'accesso ai metadati, il chiamante di questo metodo deve chiamare IUnknown::Release.

Requisiti

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