Compartilhar via


Função PeerNameToPeerHostName (p2p.h)

A função PeerNameToPeerHostName codifica o nome do par fornecido como um formato que pode ser usado com uma chamada subsequente para a função getaddrinfo Windows Sockets.

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerNameToPeerHostName(
  [in]  PCWSTR pwzPeerName,
  [out] PWSTR  *ppwzHostName
);

Parâmetros

[in] pwzPeerName

Ponteiro para uma cadeia de caracteres Unicode terminada em zero que contém o nome do par a ser codificado como um nome de host.

[out] ppwzHostName

Ponteiro para o endereço da cadeia de caracteres Unicode terminada em zero que contém o nome do host codificado. Essa cadeia de caracteres pode ser passada para getaddrinfo_v2 para obter informações de rede sobre o par.

Retornar valor

Se a chamada de função for bem-sucedida, o valor retornado será S_OK. Caso contrário, ele retornará um dos valores a seguir.

Código de retorno Descrição
E_INVALIDARG
Um dos parâmetros não é válido.
E_OUTOFMEMORY
Não há memória suficiente para executar a operação especificada.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP com SP2 [somente aplicativos da área de trabalho], Windows XP com SP1 com o Pacote de Rede Avançado para Windows XP
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho p2p.h
Biblioteca P2P.lib
DLL P2P.dll

Confira também

PeerHostNameToPeerName