Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |