Partager via


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