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은 웹 페이지가 로드된 동일한 서버를 참조해야 합니다.