#include <dwc.h>DWCCfError DWC_CfSetAppFriendKeyToNWC24Msg(NWC24MsgObj *obj,
const DWCUserData *userdata,
DWCCfMsgType msgType);| obj | Pointer to NWC24MsgObj to which to append the game Friend code. |
| userdata | Own user data. Ignored when msgType is DWC_CF_MSG_TYPE_RESPONSE_DENY. |
| msgType | Message type. |
| DWC_CF_ERROR_NONE | Succeeded. |
| Other | The DWCCfError enumerated type which indicates the error code. |
Appends information for game Friend exchanges to a NWC24MsgObj .
If never logged in before, the function will not be able to create a Friend code from the user data, and will fail.
Approximately 24 bytes of memory are consumed dynamically every time this function is called. This memory region gets released when the DWC_Shutdown is called.
If you want to explicitly release the region, call the DWC_CfReset function. However, the memory can only be released after NWC24CommitMsg has been called for the NWC24MsgObj to which information was appended for game Friend exchanges.
There is a limit on the amount of binary data that can be appended to an NWC24MsgObj, so the function will fail if that limit has already been reached when the function is called.
Only one set of information for game Friend exchanges can be appended to each NWC24MsgObj. When this function is called multiple times for the same NWC24MsgObj, the error DWC_CF_ERROR_MSGOBJ_ALREADY_SET will be returned.
CONFIDENTIAL