IUPnPDeviceControl::Initialize 메서드(upnphost.h)

Initialize 메서드는 디바이스를 초기화하는 데 사용됩니다. 디바이스 호스트는 이 메서드를 호출합니다.

구문

HRESULT Initialize(
  [in] BSTR bstrXMLDesc,
  [in] BSTR bstrDeviceIdentifier,
  [in] BSTR bstrInitString
);

[in] bstrXMLDesc

디바이스 호스트에서 게시한 전체 XML 디바이스 설명을 지정합니다. 디바이스 설명은 디바이스에서 제공하는 템플릿을 기반으로 합니다.

[in] bstrDeviceIdentifier

초기화할 디바이스를 식별합니다. IUPnPRegistrar::RegisterDevice 또는 IUPnPRegistrar::RegisterRunningDevice에서 반환하는 것과 동일한 식별자입니다. IUPnPRegistrar::GetUniqueDeviceName을 사용하여 디바이스의 UDN을 검색하는 데도 사용됩니다.

[in] bstrInitString

이 디바이스가 등록되었을 때 사용되는 초기화 문자열을 지정합니다.

이 메서드를 구현할 때 메서드가 성공하면 S_OK 반환합니다. 그렇지 않으면 WinError.h에 정의된 COM 오류 코드 중 하나를 반환합니다.

이 메서드는 디바이스 제어 개체가 인스턴스화된 직후에 호출됩니다. IUPnPDeviceControl::GetServiceObject가 호출되기 전에 호출해야 합니다.

실행 중인 디바이스와 실행되지 않는 디바이스의 차이점은 Initialize 메서드가 호출될 때입니다.

실행 중인 디바이스의 경우 IUPnPRegistrar::RegisterRunningDevice가 호출될 때 Initialize가 호출되고 IUPnPRegistrar::RegisterRunningDevice가 반환되기 전에 초기화가 완료됩니다.

실행되지 않는 디바이스의 경우 IUPnPRegistrar::RegisterDevice가 호출될 때 Initialize가 반드시 호출되지는 않습니다. 초기화 는 첫 번째 컨트롤 또는 이벤트 요청이 도착할 때 호출됩니다.

bstrDeviceIdentifier를 사용하여 IUPnPRegistrar::GetUniqueDeviceName을 호출할 수도 있습니다.