IVssExamineWriterMetadataEx::GetIdentityEx-Methode (vsbackup.h)
Die GetIdentityEx-Methode ruft den Writer instance Namen und andere grundlegende Informationen zu einem bestimmten Writer-instance ab.
Syntax
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
);
Parameter
[out] pidInstance
GuiD (Globally Unique Identifier) des Writer-instance.
[out] pidWriter
GUID der Writer-Klasse.
[out] pbstrWriterName
Zeiger auf eine Zeichenfolge, die den Namen des Writer angibt.
[out] pbstrInstanceName
Zeiger auf eine Zeichenfolge, die den Writer instance Namen angibt.
[out] pUsage
Zeiger auf einen VSS_USAGE_TYPE Enumerationswert, der angibt, wie die vom Writer verwalteten Daten auf dem Hostsystem verwendet werden.
[out] pSource
Zeiger auf einen VSS_SOURCE_TYPE Enumerationswert, der den Typ der vom Writer verwalteten Daten angibt.
Rückgabewert
Im Folgenden finden Sie die gültigen Rückgabecodes für diese Methode.
| Wert | Bedeutung |
|---|---|
|
Die Identitätsinformationen wurden erfolgreich zurückgegeben. |
|
Einer der Parameterwerte ist ungültig. |
|
Der Aufrufer verfügt über nicht genügend Arbeitsspeicher oder andere Systemressourcen. |
|
Das XML-Dokument ist ungültig. Überprüfen Sie das Ereignisprotokoll auf Details. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS. |
|
Unerwarteter Fehler. Der Fehlercode wird in der Fehlerprotokolldatei protokolliert. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS.
Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP: Dieser Wert wird erst unter Windows Server 2008 R2 und Windows 7 unterstützt. stattdessen wird E_UNEXPECTED verwendet. |
Hinweise
Diese Methode ist mit der IVssExamineWriterMetadata::GetIdentity-Methode identisch, mit Ausnahme des pbstrInstanceName-Parameters .
Der PbstrInstanceName-Parameter ist der Writer instance Name, der während der Writerinitialisierung von CVssWriter::Initialize angegeben wurde.
Der Writer instance Name ist nützlich für Writer, die die Ausführung mehrerer Writerinstanzen mit derselben Writerklassen-ID auf einem einzelnen Computer unterstützen. Der Writer instance Name kann verwendet werden, um die spezifische instance zu identifizieren. Daher muss der Writer den instance Namen innerhalb der Writer-Klasse eindeutig machen. Außerdem wird erwartet, dass der Writer instance Name zwischen Sicherung und Wiederherstellung beibehalten wird, und er wird von VSS verwendet, um mehrere instance Writer ordnungsgemäß wiederherzustellen.
Der Aufrufer muss den Arbeitsspeicher der Parameter pbstrWriterName und pbstrInstanceName durch Aufrufen von SysFreeString freigeben.
Eine IVssExamineWriterMetadataExex-Schnittstelle kann aus gespeicherten Writerzustandsinformationen stammen (erstellt durch einen Aufruf von CreateVssExamineWriterMetadata). Wenn dies der Fall ist, sind die folgenden Punkte zutreffend:
- pidInstance darf nichts in Bezug auf Live-Autoren bedeuten.
- Wenn pidWriter nicht mit der Writer-Klasse eines Live-Writers übereinstimmt, sollte ein Anforderer die Komponenten dieses Writers nicht verwenden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008, Windows Server 2003 mit SP1 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | vsbackup.h (enthalten VsBackup.h, Vss.h, VsWriter.h) |
| Bibliothek | VssApi.lib |