nn::nex::Session::QuerySessions Member Function

Syntax

static qUnsignedInt QuerySessions(
     qList< SessionDescription > * pOutputList,
     qBool bFilterMatching = true,
     qUnsignedInt32 uiTimeout = 1000
);

static qBool QuerySessions(
     CallContext * pContext,
     qList< SessionDescription > * pOutputList,
     qBool bFilterMatching = true,
     qUnsignedInt32 uiTimeout = 1000
);

Overloaded Member Functions

QuerySessions ( qList< SessionDescription > *, qBool, qUnsignedInt32 ) Searches for sessions on the LAN.
QuerySessions ( CallContext *, qList< SessionDescription > *, qBool, qUnsignedInt32 ) Searches for sessions on the LAN.

Description of QuerySessions ( qList< SessionDescription > *, qBool, qUnsignedInt32 )

When connected using a socket, checks whether another process connected to the same access point has opened a session. Using this feature allows you to skip matchmaking operations through a server, and test P2P functionality that uses a socket.

Because this overloaded function executes synchronously, it does not return until the session is successfully joined. This function can be called asynchronously, at the timing of Scheduler::Dispatch when in user thread mode. To do so, use the overloaded function that specifies CallContext.

Note: This function was designed for debugging. Do not use this function in product releases.

Description of QuerySessions ( qList< SessionDescription > *, qBool, qUnsignedInt32 )

When connected using a socket, checks whether another process connected to the same access point has opened a session. Using this feature allows you to skip matchmaking operations through a server, and test P2P functionality that uses a socket.

This overloaded function returns immediately because it executes asynchronously. (When in user thread mode, this executes when Scheduler::Dispatch is called.) Monitor execution status for the call context specified by pCallContext.

Note: This function was designed for debugging. Do not use this function in product releases.


CONFIDENTIAL