Metodo IVssExamineWriterMetadata::GetIdentity (vsbackup.h)

Articolo
03/08/2023

Il metodo GetIdentity ottiene informazioni di base su un'istanza del writer specifica.

Sintassi

HRESULT GetIdentity(
  [out] VSS_ID          *pidInstance,
  [out] VSS_ID          *pidWriter,
  [out] BSTR            *pbstrWriterName,
  [out] VSS_USAGE_TYPE  *pUsage,
  [out] VSS_SOURCE_TYPE *pSource
);

Parametri

[out] pidInstance

Indirizzo di una variabile allocata dal chiamante che riceve l'identificatore dell'istanza del writer.

[out] pidWriter

Indirizzo di una variabile allocata dal chiamante che riceve l'identificatore di classe del writer.

[out] pbstrWriterName

Indirizzo di una variabile allocata dal chiamante che riceve una stringa contenente il nome del writer.

[out] pUsage

Indirizzo di una variabile allocata dal chiamante che riceve un valore di enumerazione VSS_USAGE_TYPE che specifica la modalità di utilizzo dei dati gestiti dal writer nel sistema host.

[out] pSource

Indirizzo di una variabile allocata dal chiamante che riceve un valore di enumerazione VSS_SOURCE_TYPE che specifica il tipo di dati gestito dal writer.

Valore restituito

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

Valore	Significato
S_OK	Sono state restituite le informazioni sull'identità.
E_INVALIDARG	Uno dei valori dei parametri non è valido.
E_OUTOFMEMORY	Il chiamante non è in memoria o in altre risorse di sistema.
VSS_E_INVALID_XML_DOCUMENT	Documento XML non valido. Per informazioni dettagliate, vedere il registro eventi. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS.
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

Il chiamante deve liberare la memoria contenuta nel parametro pbstrWriterName chiamando SysFreeString.

Un'interfaccia IVssExamineWriterMetadata può essere proveniente da informazioni sullo stato del writer archiviate (create da una chiamata a CreateVssExamineWriterMetadata). In questo caso, sono vere le condizioni seguenti:

PidInstance potrebbe non significare nulla in termini di scrittori dal vivo.
Se pidWriter non corrisponde alla classe writer di alcun writer live, un richiedente non deve usare i componenti del writer.

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

Vedi anche

CreateVssExamineWriterMetadata

IVssExamineWriterMetadata

VSS_SOURCE_TYPE

VSS_USAGE_TYPE

Condividi tramite