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 |