CONST_DPENUMSESSIONFLAGS

Members of the CONST_DPENUMSESSIONFLAGS enumeration are used in the DirectPlay4.GetDPEnumSessions method to specify which sessions should be enumerated.

Enum CONST_DPENUMSESSIONFLAGS
    DPENUMSESSIONS_ALL =               2 
    DPENUMSESSIONS_ASYNC =            16 (&H10)
    DPENUMSESSIONS_AVAILABLE =         1 
    DPENUMSESSIONS_PASSWORDREQUIRED = 64 (&H40)
    DPENUMSESSIONS_RETURNSTATUS =    128 (&H80)
    DPENUMSESSIONS_STOPASYNC =        16 (&H10)
End Enum

DPENUMSESSIONS_ALL

Enumerate all active sessions, whether they are accepting new players or not. Sessions in which the player limit has been reached, new players have been disabled, or joining has been disabled will be enumerated. Password-protected sessions will not be enumerated unless the DPENUMSESSIONS_PASSWORDREQUIRED flag is also specified.

DPENUMSESSIONS_ASYNC

Enumerates all the current sessions in the session cache and returns immediately. Starts the asynchronous enumeration process if not already started. Updates to the session list continue until canceled by calling GetDPEnumSessions with the DPENUMSESSIONS_STOPASYNC flag, or by calling DirectPlay4.Open.

If this flag is not specified, the enumeration is done synchronously.

DPENUMSESSIONS_AVAILABLE

Enumerate all sessions that are accepting new players to join. Sessions that have reached their maximum number of players, have disabled new players, or have disabled joining will not be enumerated. Password-protected sessions will not be enumerated unless the DPENUMSESSIONS_PASSWORDREQUIRED flag is also specified.

DPENUMSESSIONS_PASSWORDREQUIRED

When used in combination with DPENUMSESSIONS_AVAILABLE or DPENUMSESSIONS_ALL, enables password-protected sessions to be enumerated in addition to sessions without password protection.

DPENUMSESSIONS_RETURNSTATUS

If this flag is specified, the enumeration will not display any dialog boxes showing the connection progress status. If the connection cannot be made immediately, the method will return with the DPERR_CONNECTING error. The application must keep calling GetDPEnumSessions until it succeeds or some other error code is returned.

DPENUMSESSIONS_STOPASYNC

Enumerates all the current sessions in the session cache and cancels the asynchronous enumeration process.