IUPnPDescriptionDocument：：Load 方法 (upnp.h)

Load方法會同步載入檔。這個方法不會將控制權傳回給呼叫端，直到載入作業完成為止。

語法

HRESULT Load(
  [in] BSTR bstrUrl
);

[in] bstrUrl

指定要載入的檔 URL。

如果方法成功，傳回值會S_OK。否則，方法會傳回 WinError.h 中定義的其中一個 COM 錯誤碼，或下列其中一個 UPnP 傳回值。

傳回碼	描述
UPNP_E_DEVICE_ELEMENT_EXPECTED	XML 檔沒有裝置元素。根項目或 DeviceList 元素中遺漏它。
UPnP_E_DEVICE_ELEMENT_EXPECTED	指定的描述檔中沒有 Device 元素。
UPNP_E_DEVICE_NODE_INCOMPLETE	XML 檔缺少 Device 元素的其中一個必要元素。
UPNP_E_ICON_ELEMENT_EXPECTED	XML 檔沒有圖示專案。在 IconList 元素中遺漏它，或 DeviceList 元素不包含 IconList 元素。
UPnP_E_ICON_ELEMENT_EXPECTED	指定的描述檔中沒有 Icon 元素。
UPNP_E_ICON_NODE_INCOMPLETE	XML 檔遺漏 Icon 元素的其中一個必要元素。
UPnP_E_ICON_NODE_INCOMPLETE	指定的描述檔中沒有圖示節點。
UPNP_E_ROOT_ELEMENT_EXPECTED	XML 檔在檔最上層沒有根項目。
UPnP_E_ROOT_ELEMENT_EXPECTED	指定的描述檔中沒有 Root 元素。
UPNP_E_SERVICE_ELEMENT_EXPECTED	XML 檔沒有服務專案。 ServiceList 元素遺漏它，或 DeviceList 元素不包含 ServiceList 元素。
UPNP_E_SERVICE_NODE_INCOMPLETE	XML 檔遺漏 Service 元素的其中一個必要元素。

這個方法不應該從使用者介面執行緒呼叫，因為方法傳回可能需要很長的時間。

如果 Load 方法是由網頁內的腳本呼叫， bstrUrl 可能是相對 URL。目前網頁的位址會當做基底 URL 使用。

如果從網頁呼叫這個方法，則呼叫端指定的 URL 必須參考載入網頁所在的相同伺服器。