IUPnPDeviceControl：：Initialize 方法 (upnphost.h)

Initialize 方法用于初始化设备。设备主机调用此方法。

语法

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

[in] bstrXMLDesc

指定由设备主机发布的完整 XML 设备说明。设备说明基于设备提供的模板。

[in] bstrDeviceIdentifier

[in] bstrInitString

指定注册此设备时使用的初始化字符串。

实现此方法时，如果方法成功，则返回S_OK。否则，返回 WinError.h 中定义的 COM 错误代码之一。

实例化设备控制对象后，将立即调用此方法。必须在调用 IUPnPDeviceControl：：GetServiceObject 之前调用它。

正在运行的设备和非正在运行的设备之间的区别在于调用 Initialize 方法时。

对于正在运行的设备，在调用 IUPnPRegistrar：：RegisterRunningDevice 时调用 Initialize，并在 IUPnPRegistrar：：RegisterRunningDevice 返回之前完成初始化。

对于非正在运行的设备，在调用 IUPnPRegistrar：：RegisterDevice 时不一定调用 Initialize。当第一个控件或事件请求到达时，将调用 Initialize。

bstrDeviceIdentifier 还可用于调用 IUPnPRegistrar：：GetUniqueDeviceName。