nn::nex::MatchmakeExtensionClient::UpdateApplicationBuffer Member Function

Syntax

qBool UpdateApplicationBuffer(
     ProtocolCallContext * pContext,
     GatheringID gid,
     qVector< qUnsignedInt8 > applicationBuffer
);

Parameters

Name Description
in pContext Call information.
in gid The ID of the matchmaking session for which an attribute is to be changed.
in applicationBuffer Application-defined data. MATCHMAKE_BUFFER_MAX_LENGTH is the maximum number of bytes of data that can be set.

Return Values



Value Description
true Call initialization succeeded.
false Failure.

Description

Updates application-defined data for a matchmaking session.

Updates application-defined data for the specified matchmaking session. Only the owner of the matchmaking session can do this.

The following results may be returned as a result of asynchronous operation. Use the application to handle these results.

QERROR(RendezVous, SessionVoid): The matchmaking session does not exist.
QERROR(RendezVous, PermissionDenied)
: The caller is not the owner.

The following results may be returned as a result of asynchronous operation. Pass errors to the Error/EULA applet. This error must be removed during debugging.

QERROR(Core, InvalidArgument): An attempt was made to send data longer than MATCHMAKE_BUFFER_MAX_LENGTH.

Revision History

2014/04/08
Corrected QERROR(Core, InvalidArgment) to QERROR(Core, InvalidArgument) in the description.
2014/03/28
Changed the function so that it returns QERROR(RendezVous, PermissionDenied) instead of success without doing anything when it is called by a station that is not the owner of the matchmaking session.
2013/11/28
Corrected the description so that QERROR(Core, InvalidArgument) is not handled by the application, but the error is passed to the error/EULA applet.
2011/01/27
Initial version.

CONFIDENTIAL