IVssWMFiledesc::GetPath-Methode (vswriter.h)

Die GetPath-Methode ruft den vollqualifizierten Verzeichnispfad oder den UNC-Pfad der Remotedateifreigabe ab, um die Liste der Dateien abzurufen, die im aktuellen IVssWMFiledesc-Objekt beschrieben sind.

Eine Abfragemethode verwendet diesen Pfad und eine Dateispezifikation, um das aktuelle IVssWMFiledesc-Objekt zurückzugeben.

Syntax

HRESULT GetPath(
  [out] BSTR *pbstrPath
);

Parameter

[out] pbstrPath

Die Adresse einer vom Aufrufer zugewiesenen Variablen, die eine MIT NULL beendete breite Zeichenfolge empfängt, die den vollqualifizierten Verzeichnispfad oder den UNC-Pfad des Remotedateifreigabeverzeichnisses angibt.

Der Pfad kann ein langer oder kurzer Dateiname sein und das Präfix "\?" verwenden. Weitere Informationen finden Sie unter Benennen einer Datei.

Benutzer dieser Methode müssen überprüfen, ob dieser Pfad mit einem umgekehrten Schrägstrich ("") endet.

Rückgabewert

Im Folgenden sind die gültigen Rückgabecodes für diese Methode aufgeführt.

Wert Bedeutung
S_OK
Die Pfadinformationen wurden erfolgreich zurückgegeben.
E_INVALIDARG
Einer der Parameterwerte ist ungültig.
E_OUTOFMEMORY
Der Aufrufer verfügt nicht über Arbeitsspeicher oder andere Systemressourcen.
VSS_E_INVALID_XML_DOCUMENT
Das XML-Dokument ist ungültig. Überprüfen Sie das Ereignisprotokoll auf Details. Weitere Informationen finden Sie unter Ereignis- und Fehlerbehandlung unter VSS.
VSS_E_UNEXPECTED
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

Windows 7, Windows Server 2008 R2, Windows Vista, Windows Server 2008, Windows XP und Windows Server 2003: Remotedateifreigaben werden erst unter Windows 8 und Windows Server 2012 unterstützt.

Der Aufrufer muss SysFreeString aufrufen, um den arbeitsspeicher des pbstrPath-Parameters freizugeben.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile vswriter.h (einschließlich Vss.h, VsWriter.h)
Bibliothek VssApi.lib

Weitere Informationen

IVssWMFiledesc