IVssWMDependency：：GetLogicalPath 方法 (vswriter.h)

GetLogicalPath 方法會擷取目前元件相依於明確寫入器元件相依性的元件邏輯路徑。

語法

HRESULT GetLogicalPath(
  [out] BSTR *pbstrLogicalPath
);

[out] pbstrLogicalPath

呼叫端配置的變數位址，接收 NULL終止的寬字元字串，其中包含目前元件相依之元件的邏輯路徑。

這個方法可以傳回下列其中一個值。

值	意義
S_OK	已成功傳回目前元件相依之元件的邏輯路徑。
S_FALSE	找不到管理目前元件相依元件的寫入器。
E_INVALIDARG	pbstrLogicalPath 指標指向未配置的記憶體。
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 釋放傳回字串所使用的記憶體。

相依性不會指出元件與所依存元件之間的喜好設定順序。相依性只表示元件及其相依元件必須一律一起備份或還原。

可以有多個指定寫入器類別的實例;不過，任何元件的邏輯路徑和名稱都應該是唯一的。

如果寫入器類別有多個實例，則必須使用邏輯路徑和元件名稱資訊來識別管理目前元件相依元件的實例。