PeerEnumIdentities (Windows CE 5.0)
This function creates and returns a peer enumeration handle that is used to enumerate all the peer identities that belong to a specific user.
HRESULT WINAPI PeerEnumIdentities( HPEERENUM* phPeerEnum);
Parameters
- phPeerEnum
[out] Receives a handle to the peer enumeration that contains the list of peer identities, with each item represented as a pointer to a PEER_NAME_PAIR_TAG structure. Pass this handle to PeerGetNextItem to retrieve the items. When it is finished, call PeerEndEnumeration to release the memory.
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. |
Remarks
Once the application has obtained the peer enumeration handle, use PeerGetNextItem and PeerGetItemCount to enumerate the peer identities.
When it enumerates peer identities, PeerGetNextItem returns an array of pointers to PEER_NAME_PAIR_TAG structures.
Call PeerEndEnumeration to free the enumeration handle when it is no longer required.
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