Compartilhar via

Método IUPnPRegistrar::GetUniqueDeviceName (upnphost.h)

  • Artigo

O método GetUniqueDeviceName recupera o UDN para o dispositivo especificado. A UDN foi gerada pelo host do dispositivo para cada dispositivo inserido. A UDN do modelo na descrição do dispositivo é substituída por essa UDN gerada para cada dispositivo inserido quando o dispositivo é registrado. Esse método é reentrante.

Sintaxe

HRESULT GetUniqueDeviceName(
  [in]  BSTR bstrDeviceIdentifier,
  [in]  BSTR bstrTemplateUDN,
  [out] BSTR *pbstrUDN
);

Parâmetros

[in] bstrDeviceIdentifier

Especifica o identificador retornado por RegisterDevice ou RegisterRunningDevice.

[in] bstrTemplateUDN

Especifica a UDN do modelo de descrição do dispositivo.

[out] pbstrUDN

Recebe o UDN do dispositivo que foi gerado pelo host do dispositivo.

Retornar valor

Se o método 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

Cada UDN especificada para um dispositivo no modelo de descrição do dispositivo é substituída durante o registro. O host do dispositivo substitui cada UDN por uma globalmente exclusiva.

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 upnphost.h
DLL Upnphost.dll

Confira também

Iupnpregistrar