IVssExamineWriterMetadata::GetIdentity-Methode (vsbackup.h)
Die GetIdentity-Methode ruft grundlegende Informationen zu einem bestimmten Writer instance ab.
Syntax
HRESULT GetIdentity(
[out] VSS_ID *pidInstance,
[out] VSS_ID *pidWriter,
[out] BSTR *pbstrWriterName,
[out] VSS_USAGE_TYPE *pUsage,
[out] VSS_SOURCE_TYPE *pSource
);
Parameter
[out] pidInstance
Die Adresse einer vom Aufrufer zugewiesenen Variablen, die den instance Bezeichner des Writers empfängt.
[out] pidWriter
Die Adresse einer vom Aufrufer zugewiesenen Variablen, die den Klassenbezeichner des Writer empfängt.
[out] pbstrWriterName
Die Adresse einer vom Aufrufer zugewiesenen Variablen, die eine Zeichenfolge empfängt, die den Namen des Writer enthält.
[out] pUsage
Die Adresse einer vom Aufrufer zugewiesenen Variablen, die einen VSS_USAGE_TYPE Enumerationswert empfängt, der angibt, wie die vom Writer verwalteten Daten auf dem Hostsystem verwendet werden.
[out] pSource
Die Adresse einer vom Aufrufer zugewiesenen Variablen, die einen VSS_SOURCE_TYPE Enumerationswert empfängt, der den Typ der vom Writer verwalteten Daten angibt.
Rückgabewert
Im Folgenden sind die gültigen Rückgabecodes für diese Methode aufgeführt.
| Wert | Bedeutung |
|---|---|
|
Die Identitätsinformationen wurden erfolgreich zurückgegeben. |
|
Einer der Parameterwerte ist ungültig. |
|
Der Aufrufer verfügt nicht über 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
Der Aufrufer muss den Arbeitsspeicher des PbstrWriterName-Parameters durch Aufrufen von SysFreeString freigeben.
Eine IVssExamineWriterMetadata-Schnittstelle kann aus gespeicherten Writerstatusinformationen stammen (erstellt durch einen Aufruf von CreateVssExamineWriterMetadata). Wenn dies der Fall ist, gilt Folgendes:
- pidInstance darf nichts in Bezug auf lebende 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 XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | vsbackup.h (einschließlich VsBackup.h, Vss.h, VsWriter.h) |
| Bibliothek | VssApi.lib |