Méthode IUPnPRegistrar ::GetUniqueDeviceName (upnphost.h)
La méthode GetUniqueDeviceName récupère l’UDN pour l’appareil spécifié. L’UDN a été généré par l’hôte de l’appareil pour chaque appareil incorporé. L’UDN de modèle dans la description de l’appareil est remplacé par cet UDN généré pour chaque appareil incorporé lorsque l’appareil est inscrit. Cette méthode est réinscrite.
Syntaxe
HRESULT GetUniqueDeviceName(
[in] BSTR bstrDeviceIdentifier,
[in] BSTR bstrTemplateUDN,
[out] BSTR *pbstrUDN
);
Paramètres
[in] bstrDeviceIdentifier
Spécifie l’identificateur retourné par RegisterDevice ou RegisterRunningDevice.
[in] bstrTemplateUDN
Spécifie l’UDN à partir du modèle de description de l’appareil.
[out] pbstrUDN
Reçoit l’UDN de l’appareil qui a été généré par l’hôte de l’appareil.
Valeur retournée
Si la méthode réussit, la valeur de retour est S_OK. Sinon, la méthode retourne l’un des codes d’erreur COM définis dans WinError.h.
Remarques
Chaque nom d’utilisateur spécifié pour un appareil dans le modèle de description de l’appareil est remplacé lors de l’inscription. L’hôte de l’appareil remplace chaque UDN par un nom global unique.
Configuration requise
| Condition requise | Valeur |
|---|---|
| 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 |