NWC24GetFriendInfoStatus

C Specification

#include <revolution/nwc24.h>

NWC24Err NWC24GetFriendInfoStatus( u32* type, u32* status, u32 index );

Description

Simple way of checking the registration status of the information in the index position in the Wii Friend Roster.

Note: Friend information is not necessarily always stored in order starting from the 0th index.

Arguments

type

Pointer to the variable that gets the information at the registered address. Depending on the registration status of the information in the index position in the Wii Friend Roster, one of the following values is returned:

Value	Description
`NWC24_FI_TYPE_NONE`	Nothing is registered (open field).
`NWC24_FI_TYPE_WII`	A Wii address (a Wii number) is registered.
`NWC24_FI_TYPE_PUBLIC`	A regular e-mail address is registered.

status

Pointer to the variable that gets the status of the friend relationship for the registered address. Depending on the friend relationship status of the information in the index position in the Wii's Friend Roster, one of the following values is returned:

Value	Description
`NWC24_FI_STAT_NONE`	Nothing is registered (open field).
`NWC24_FI_STAT_PENDING`	Relationship is not yet established.
`NWC24_FI_STAT_ESTABLISHED`	Relationship is established.

index The index within the friend roster.

Return Values

NWC24_OK: Status information gotten normally.
NWC24_ERR_LIB_NOT_OPENED: The library is not open.
NWC24_ERR_FILE_*: There is a problem accessing the file.
NWC24_ERR_BROKEN: The Friend Roster is corrupted.
NWC24_ERR_VER_MISMATCH: Friend Roster version error.

Revision History

2007/07/09 Initial version.