nn::nex::UtilityClient::AssociateNexUniqueIdWithMyPrincipalId Member Function

Syntax

qBool AssociateNexUniqueIdWithMyPrincipalId(
     ProtocolCallContext * pContext,
     const UniqueIdInfo & uniqueIdInfo
);

Parameters

Name Description
in pContext The call context.
in uniqueIdInfo NEX unique ID and password to associate.

Return Values

Returns the result of the operation.

Description

Associates a NEX unique ID with the local user's principal ID.

Registers the NEX unique ID specified in uniqueIdInfo as the primary associated NEX unique ID and deletes any other associations. If INVALID_UNIQUEID is specified as the NEX unique ID, all associations are deleted.

If you specify a NEX unique ID that is already associated with a different user, the other user must be offline. If that user is online, QERROR(RendezVous, DuplicateEntry) is returned.

Revision History

2014/02/03
Added description of behavior when a NEX unique ID associated with another user is specified.
2013/12/06
Initial version.

CONFIDENTIAL