PeerIdentityGetXML (Windows CE 5.0)
This function retrieves a description of the peer identity. This can then be passed to third parties and used to invite a peer identity into a peer-to-peer group. This information is returned as an XML fragment.
HRESULT WINAPI PeerIdentityGetXML( PCWSTR pwzIdentity, PWSTR* ppwzIdentityXML);
Parameters
- pwzIdentity
[in] Specifies the peer identity to retrieve peer identity information for. - ppwzIdentityXML
[out] Pointer to a pointer to a Unicode string that contains the XML fragment. When ppwzIdentityXML is no longer required, the application is responsible for freeing this string by calling PeerFreeData.
Return Values
The following table shows the possible return values.
| Value | Description |
|---|---|
| S_OK | Function call succeeded. |
| E_HANDLE | The handle to the identity is invalid. |
| E_INVALIDARG | One of the parameters is not valid. |
| E_OUTOFMEMORY | There is not enough memory to perform the specified operation. |
Remarks
The XML fragment that is returned has the following structure:
<PEERIDENTITYINFO VERSION="1.0">
<IDC xmlns:dt="urn:schemas-microsoft-com:datatypes" dt:dt="bin.base64">
Base 64 encoded certificate.
</IDC>
</PEERIDENTITYINFO>
This XML fragment is used when you create an invitation to join a group.
Applications cannot add tags within the <PEERIDENTITYINFO> tag or modify this XML fragment in any way. Applications can incorporate this XML fragment into other XML documents, but they must strip out all application-specific XML before passing this fragment to the PeerGroupCreateInvitation.
Requirements
OS Versions: Windows CE 5.0 and later.
Header: p2p.h.
Link Library: p2p.lib.
See Also
Send Feedback on this topic to the authors