Metodo IVssExamineWriterMetadataEx::GetIdentityEx (vsbackup.h)

Articolo
03/13/2024

Il metodo GetIdentityEx ottiene il nome dell'istanza del writer e altre informazioni di base su un'istanza del writer specifica.

Sintassi

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

Parametri

[out] pidInstance

Identificatore univoco globale (GUID) dell'istanza del writer.

[out] pidWriter

GUID della classe writer.

[out] pbstrWriterName

Puntatore a una stringa che specifica il nome del writer.

[out] pbstrInstanceName

Puntatore a una stringa che specifica il nome dell'istanza del writer.

[out] pUsage

Puntatore a un valore di enumerazione VSS_USAGE_TYPE che indica come vengono usati i dati gestiti dal writer nel sistema host.

[out] pSource

Puntatore a un valore di enumerazione VSS_SOURCE_TYPE che indica il tipo di dati gestiti 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

Questo metodo è identico al metodo IVssExamineWriterMetadata::GetIdentity , ad eccezione del parametro pbstrInstanceName .

Il parametro pbstrInstanceName è il nome dell'istanza del writer specificato durante l'inizializzazione del writer da CVssWriter::Initialize.

Il nome dell'istanza del writer è utile per i writer che supportano l'esecuzione di più istanze del writer con lo stesso ID classe writer in un singolo computer. Il nome dell'istanza del writer può essere usato per identificare l'istanza specifica. Pertanto, il writer deve rendere univoco il nome dell'istanza all'interno della classe writer. Inoltre, il nome dell'istanza del writer deve essere persistente tra il backup e il ripristino e viene usato da VsS per ripristinare correttamente più writer di istanze.

Il chiamante deve liberare la memoria contenuta nei parametri pbstrWriterName e pbstrInstanceName chiamando SysFreeString.

Un'interfaccia IVssExamineWriterMetadataEx 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 Vista [solo app desktop]
Server minimo supportato	Windows Server 2008, Windows Server 2003 con SP1 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vsbackup.h (include VsBackup.h, Vss.h, VsWriter.h)
Libreria	VssApi.lib

Vedi anche

CVssWriter::Initialize

IVssExamineWriterMetadataEx

Condividi tramite