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 |
|---|---|
|
Die Pfadinformationen 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
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 |