共用方式為


IVssWMDependency::GetComponentName 方法 (vswriter.h)

GetComponentName 方法會擷取目前元件相依於明確寫入器元件相依性的元件名稱。

語法

HRESULT GetComponentName(
  BSTR *pbstrComponentName
);

參數

pbstrComponentName

呼叫端配置的變數位址,該變數會接收 NULL終止的寬字元字串,其中包含目前元件相依的元件名稱。

傳回值

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

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

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

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

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

規格需求

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

另請參閱

IVssWMComponent::GetDependency

IVssWMDependency

IVssWMDependency::GetLogicalPath

IVssWMDependency::GetWriterId