Compartilhar via


Método IUPnPDevice::get_SerialNumber (upnp.h)

A propriedade SerialNumber especifica uma forma legível por humanos do número de série do dispositivo.

Sintaxe

HRESULT get_SerialNumber(
  [out] BSTR *pbstr
);

Parâmetros

[out] pbstr

Recebe uma referência a uma cadeia de caracteres que contém o número de série. Libere essa cadeia de caracteres com SysFreeString quando ela não for mais usada. Essa propriedade é opcional e o dispositivo pode não ter um número de série.

Valor retornado

Para C++: se o método "get" dessa propriedade for bem-sucedido, o valor retornado será S_OK. Se o dispositivo não tiver especificado um número de série, o valor retornado será S_FALSE. Caso contrário, o método retornará um dos códigos de erro COM definidos em WinError.h.

Comentários

Essa propriedade é opcional e pbstr pode ser NULL.

É possível que vários dispositivos tenham o mesmo número de série. Para determinar se dois objetos de dispositivo descrevem o mesmo dispositivo, use o nome exclusivo do dispositivo. Para obter mais informações, consulte UniqueDeviceName.

Requisitos

   
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Nenhum compatível
Plataforma de Destino Windows
Cabeçalho upnp.h
DLL Upnp.dll

Confira também

Iupnpdevice

IUPnPDevice::UniqueDeviceName