Metodo IVssExamineWriterMetadata::GetIdentity (vsbackup.h)

  • Articolo

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