IUPnPDeviceControl::Initialize, méthode (upnphost.h)
La méthode Initialize est utilisée pour initialiser l’appareil. L’hôte de l’appareil appelle cette méthode.
Syntaxe
HRESULT Initialize(
[in] BSTR bstrXMLDesc,
[in] BSTR bstrDeviceIdentifier,
[in] BSTR bstrInitString
);
Paramètres
[in] bstrXMLDesc
Spécifie la description complète de l’appareil XML, telle que publiée par l’hôte de l’appareil. La description de l’appareil est basée sur le modèle fourni par l’appareil.
[in] bstrDeviceIdentifier
Identifie l’appareil à initialiser. Il s’agit du même identificateur retourné par IUPnPRegistrar::RegisterDevice ou IUPnPRegistrar::RegisterRunningDevice. Il est également utilisé pour récupérer l’UDN de l’appareil à l’aide de IUPnPRegistrar::GetUniqueDeviceName.
[in] bstrInitString
Spécifie la chaîne d’initialisation utilisée lors de l’inscription de cet appareil.
Valeur retournée
Lors de l’implémentation de cette méthode, retournez S_OK si la méthode réussit. Sinon, retournez l’un des codes d’erreur COM définis dans WinError.h.
Remarques
Cette méthode est appelée immédiatement après l’instanciation de l’objet de contrôle d’appareil. Il doit être appelé avant qu’IUPnPDeviceControl::GetServiceObject soit appelé.
La différence entre un appareil en cours d’exécution et un appareil non en cours d’exécution est lorsque la méthode Initialize est appelée.
Pour les appareils en cours d’exécution, Initialize est appelé lorsque IUPnPRegistrar::RegisterRunningDevice est appelé, et que l’initialisation est terminée avant que IUPnPRegistrar::RegisterRunningDevice ne retourne.
Pour les appareils non en cours d’exécution, Initialize n’est pas nécessairement appelé lorsque IUPnPRegistrar::RegisterDevice est appelé. Initialize est appelé lorsque la première demande de contrôle ou d’événement arrive.
Le bstrDeviceIdentifier peut également être utilisé pour appeler IUPnPRegistrar::GetUniqueDeviceName.
Configuration requise
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Aucun pris en charge |
| Plateforme cible | Windows |
| En-tête | upnphost.h |
| DLL | Upnphost.dll |