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 釋放傳回字串所使用的記憶體。

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

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

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