PeerCreatePeerName (Windows CE 5.0)

Send Feedback

This function creates a name based on an existing name of the specified peer identity and classifier. However, this function does not create a new identity.

HRESULT WINAPI PeerCreatePeerName(  PCWSTR pwzIdentity,  PCWSTR pwzClassifier,  PWSTR* ppwzPeerName);

Parameters

  • pwzIdentity
    [in] 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.

  • pwzClassifier
    [in] 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.

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

Return Values

The following table shows the possible return values.

Value Description
S_OK Function call succeeded.
E_INVALIDARG One of the parameters is not valid.
E_OUTOFMEMORY There is not enough memory to perform the specified operation.

Requirements

OS Versions: Windows CE 5.0 and later.
Header: p2p.h.
Link Library: p2p.lib.

See Also

Identity Manager Functions

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.