nn::friends::CTR::GetFriendKeyList Function

Syntax

Result GetFriendKeyList(
     FriendKey * pFriendKeyList,
     size_t * pNum,
     size_t offset = 0,
     size_t size = FRIEND_LIST_SIZE
);

Arguments

Name Description
out pFriendKeyList Specifies a pointer to a buffer that stores obtained friend keys.
out pNum Specifies a pointer to a buffer that stores the number actually obtained.
in offset Specifies the index of the friend key to begin obtaining.
in size Specifies the maximum number of friend keys to obtain (the number of buffer elements).

Return Values

Returns the result of the operation.

Value Description
ResultSuccess Process succeeded.
ResultInvalidPointer An invalid pointer was passed in as an argument.
ResultTooLarge The size argument was too large.
ResultNotInitialized The friend presence library has not been initialized.
Other Some other result may be returned as a result of factors such as the daemon's internal state.

Description

Gets a list of the friend keys registered in the friend list.

The obtained friend keys also include peers who have not yet established a friend relationship with the local host.

Revision History

2011/03/11
Added specific examples of return values.
2010/08/16
Initial version.

CONFIDENTIAL