IUPnPDeviceControl::Initialize-Methode (upnphost.h)

Die Initialize-Methode wird verwendet, um das Gerät zu initialisieren. Der Gerätehost ruft diese Methode auf.

Syntax

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

Parameter

[in] bstrXMLDesc

Gibt die vollständige XML-Gerätebeschreibung an, die vom Gerätehost veröffentlicht wird. Die Gerätebeschreibung basiert auf der vorlage, die vom Gerät bereitgestellt wird.

[in] bstrDeviceIdentifier

Identifiziert das zu initialisierende Gerät. Dies ist derselbe Bezeichner, der von IUPnPRegistrar::RegisterDevice oder IUPnPRegistrar::RegisterRunningDevice zurückgegeben wird. Sie wird auch verwendet, um den UDN des Geräts mithilfe von IUPnPRegistrar::GetUniqueDeviceName abzurufen.

[in] bstrInitString

Gibt die Initialisierungszeichenfolge an, die bei der Registrierung dieses Geräts verwendet wurde.

Rückgabewert

Geben Sie bei der Implementierung dieser Methode S_OK zurück, wenn die Methode erfolgreich ist. Geben Sie andernfalls einen der com-Fehlercodes zurück, die in WinError.h definiert sind.

Hinweise

Diese Methode wird unmittelbar nach der Instanziierung des Gerätesteuerungsobjekts aufgerufen. Es muss aufgerufen werden, bevor IUPnPDeviceControl::GetServiceObject aufgerufen wird.

Der Unterschied zwischen einem ausgeführten Gerät und einem nicht ausgeführten Gerät besteht darin, wenn die Initialize-Methode aufgerufen wird.

Für ausgeführte Geräte wird Initialize aufgerufen, wenn IUPnPRegistrar::RegisterRunningDevice aufgerufen wird, und die Initialisierung wird abgeschlossen, bevor IUPnPRegistrar::RegisterRunningDevice zurückgegeben wird.

Für nicht ausgeführte Geräte wird Initialize nicht notwendigerweise aufgerufen, wenn IUPnPRegistrar::RegisterDevice aufgerufen wird. Initialize wird aufgerufen, wenn die erste Steuerelement- oder Ereignisanforderung eingeht.

Der bstrDeviceIdentifier kann auch zum Aufrufen von IUPnPRegistrar::GetUniqueDeviceName verwendet werden.

Anforderungen

Weitere Informationen

GetServiceObject

IUPnPDeviceControl