共用方式為


IVssWMFiledesc::GetFilespec 方法 (vswriter.h)

GetFilespec 方法會傳回用來取得目前 IVssWMFiledesc 物件所屬檔案清單的檔案規格。

查詢方法使用路徑和這個檔案規格傳回目前的 IVssWMFiledesc 物件。

語法

HRESULT GetFilespec(
  [out] BSTR *pbstrFilespec
);

參數

[out] pbstrFilespec

呼叫端配置的變數位址,該變數會接收指定傳回檔案規格的字元串。

例如,檔案規格不能包含目錄規格 (,沒有反斜杠) 但可以包含 ? 和 * 通配符。

傳回值

以下是這個方法的有效傳回碼。

意義
S_OK
已成功傳回 filespec 資訊。
E_INVALIDARG
其中一個參數值無效。
E_OUTOFMEMORY
呼叫端記憶體不足或其他系統資源。
VSS_E_INVALID_XML_DOCUMENT
XML 檔無效。 請檢查事件記錄檔以取得詳細數據。 如需詳細資訊,請參閱 VSS 下的事件和錯誤處理
VSS_E_UNEXPECTED
非預期的錯誤。 錯誤碼會記錄在錯誤記錄檔中。 如需詳細資訊,請參閱 VSS 下的事件和錯誤處理

Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP: 在 Windows Server 2008 R2 和 Windows 7 之前,不支援此值。 E_UNEXPECTED改用。

備註

呼叫端必須呼叫 SysFreeString ,以釋放 pbstrFilespec 參數所持有的記憶體。

規格需求

需求
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 vswriter.h (包括 Vss.h、VsWriter.h)
程式庫 VssApi.lib

另請參閱

IVssWMFiledesc