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 が必ずしも呼び出されるとは限りません。 Initialize は、最初のコントロールまたはイベント要求が到着したときに呼び出されます。

bstrDeviceIdentifier を使用して、IUPnPRegistrar::GetUniqueDeviceName を呼び出すこともできます。