PeerNameToPeerHostName function (p2p.h)

The PeerNameToPeerHostName function encodes the supplied peer name as a format that can be used with a subsequent call to the getaddrinfo Windows Sockets function.

Syntax

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

Parameters

[in] pwzPeerName

Pointer to a zero-terminated Unicode string that contains the peer name to encode as a host name.

[out] ppwzHostName

Pointer to the address of the zero-terminated Unicode string that contains the encoded host name. This string can be passed to getaddrinfo_v2 to obtain network information about the peer.

Return value

If the function call succeeds, the return value is S_OK. Otherwise, it returns one of the following values.

Return code Description
E_INVALIDARG
One of the parameters is not valid.
E_OUTOFMEMORY
There is not enough memory to perform the specified operation.

Requirements

Requirement Value
Minimum supported client Windows XP with SP2 [desktop apps only],Windows XP with SP1 with the Advanced Networking Pack for Windows XP
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header p2p.h
Library P2P.lib
DLL P2P.dll

See also

PeerHostNameToPeerName