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。