PeerCreatePeerName function (p2p.h)

The PeerCreatePeerName function creates a new name based on the existing name of the specified peer identity and classifier. However, a new identity is not created by a call to PeerCreatePeerName.

Syntax

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCreatePeerName(
  [in]  PCWSTR pwzIdentity,
  [in]  PCWSTR pwzClassifier,
  [out] PWSTR  *ppwzPeerName
);

Parameters

[in] pwzIdentity

Specifies the identity to use as the basis for the new peer name. If pwzIdentity is NULL, the name created is not based on any peer identity, and is therefore an unsecured name.

This parameter can only be NULL if pwzClassifier is not NULL.

[in] pwzClassifier

Pointer to the Unicode string that contains the new classifier. This classifier is appended to the existing authority portion of the peer name of the specified identity. This string is 150 characters long, including the NULL terminator. Specify NULL to return the peer name of the identity.

This parameter can only be NULL if pwzIdentity is not NULL.

[out] ppwzPeerName

Pointer that receives a pointer to the new peer name. When this string is not required anymore, free it by calling PeerFreeData.

Return value

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

Remarks

The parameter ppwzPeername must be set to null before the PeerCreatePeerName function is called.

Requirements

See also

PeerFreeData