Méthode IUPnPDevice::get_SerialNumber (upnp.h)
La propriété SerialNumber spécifie une forme lisible par l’homme du numéro de série de l’appareil.
Syntaxe
HRESULT get_SerialNumber(
[out] BSTR *pbstr
);
Paramètres
[out] pbstr
Reçoit une référence à une chaîne qui contient le numéro de série. Relâchez cette chaîne avec SysFreeString lorsqu’elle n’est plus utilisée. Cette propriété est facultative et l’appareil peut ne pas avoir de numéro de série.
Valeur retournée
Pour C++: si la méthode « get » de cette propriété réussit, la valeur de retour est S_OK. Si l’appareil n’a pas spécifié de numéro de série, la valeur de retour est S_FALSE. Sinon, la méthode retourne l’un des codes d’erreur COM définis dans WinError.h.
Remarques
Cette propriété est facultative et pbstr peut avoir la valeur NULL.
Il est possible que plusieurs appareils aient le même numéro de série. Pour déterminer si deux objets d’appareil décrivent le même appareil, utilisez le nom unique de l’appareil. Pour plus d’informations, consultez UniqueDeviceName.
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 | upnp.h |
| DLL | Upnp.dll |