Compartilhar via


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

A propriedade FriendlyName especifica o nome de exibição do dispositivo para o dispositivo.

Sintaxe

HRESULT get_FriendlyName(
  [out] BSTR *pbstr
);

Parâmetros

[out] pbstr

Recebe uma referência a uma cadeia de caracteres que contém o nome de exibição do dispositivo. Solte essa cadeia de caracteres com SysFreeString quando ela não for mais necessária.

Retornar valor

Para C++: se o método "get" dessa propriedade for bem-sucedido, o valor retornado será S_OK. Caso contrário, o método retornará um dos códigos de erro COM definidos em WinError.h.

Comentários

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

Requisitos

Requisito Valor
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

UniqueDeviceName