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

Voir aussi

IUPnPDevice

IUPnPDevice::UniqueDeviceName