Index Topic Contents | |||
Previous Topic: DPLPROPERTY_PlayerScore Next Topic: Further Reading |
Return Values
Errors are represented by negative values and cannot be combined. This table lists the values that can be returned by all IDirectPlay3 Interface and IDirectPlayLobby2 Interface methods. For a list of the error values each method can return, see the individual method descriptions.
- CLASS_E_NOAGGREGATION
- A non-NULL value was passed for the pUnkOuter parameter in DirectPlayCreate, DirectPlayLobbyCreate, or IDirectPlayLobby2::Connect.
- DP_OK
- The request completed successfully.
- DPERR_ACCESSDENIED
- The session is full or an incorrect password was supplied.
- DPERR_ACTIVEPLAYERS
- The requested operation cannot be performed because there are existing active players.
- DPERR_ALREADYINITIALIZED
- This object is already initialized.
- DPERR_APPNOTSTARTED
- The application has not been started yet.
- DPERR_AUTHENTICATIONFAILED
- The password or credentials supplied could not be authenticated.
- DPERR_BUFFERTOOLARGE
- The data buffer is too large to store.
- DPERR_BUSY
- A message cannot be sent because the transmission medium is busy.
- DPERR_BUFFERTOOSMALL
- The supplied buffer is not large enough to contain the requested data.
- DPERR_CANTADDPLAYER
- The player cannot be added to the session.
- DPERR_CANTCREATEGROUP
- A new group cannot be created.
- DPERR_CANTCREATEPLAYER
- A new player cannot be created.
- DPERR_CANTCREATEPROCESS
- Cannot start the application.
- DPERR_CANTCREATESESSION
- A new session cannot be created.
- DPERR_CANTLOADCAPI
- No credentials were supplied and the CryptoAPI package (CAPI) to use for cryptography services cannot be loaded.
- DPERR_CANTLOADSECURITYPACKAGE
- The software security package cannot be loaded.
- DPERR_CANTLOADSSPI
- No credentials were supplied and the software security package (SSPI) that will prompt for credentials cannot be loaded.
- DPERR_CAPSNOTAVAILABLEYET
- The capabilities of the DirectPlay object have not been determined yet. This error will occur if the DirectPlay object is implemented on a connectivity solution that requires polling to determine available bandwidth and latency.
- DPERR_CONNECTING
- The method is in the process of connecting to the network. The application should keep calling the method until it returns DP_OK, indicating successful completion, or it returns a different error.
- DPERR_ENCRYPTIONFAILED
- The requested information could not be digitally encrypted. Encryption is used for message privacy. This error is only relevant in a secure session.
- DPERR_EXCEPTION
- An exception occurred when processing the request.
- DPERR_GENERIC
- An undefined error condition occurred.
- DPERR_INVALIDCREDENTIALS
- The credentials supplied (as to IDirectPlay3::SecureOpen) were not valid.
- DPERR_INVALIDFLAGS
- The flags passed to this method are invalid.
- DPERR_INVALIDGROUP
- The group ID is not recognized as a valid group ID for this game session.
- DPERR_INVALIDINTERFACE
- The interface parameter is invalid.
- DPERR_INVALIDOBJECT
- The DirectPlay object pointer is invalid.
- DPERR_INVALIDPARAMS
- One or more of the parameters passed to the method are invalid.
- DPERR_INVALIDPASSWORD
- An invalid password was supplied when attempting to join a session that requires a password.
- DPERR_INVALIDPLAYER
- The player ID is not recognized as a valid player ID for this game session.
- DPERR_LOGONDENIED
- The session could not be opened because credentials are required and either no credentials were supplied or the credentials were invalid.
- DPERR_NOCAPS
- The communication link that DirectPlay is attempting to use is not capable of this function.
- DPERR_NOCONNECTION
- No communication link was established.
- DPERR_NOINTERFACE
- The interface is not supported.
- DPERR_NOMESSAGES
- There are no messages in the receive queue.
- DPERR_NONAMESERVERFOUND
- No name server (host) could be found or created. A host must exist to create a player.
- DPERR_NONEWPLAYERS
- The session is not accepting any new players.
- DPERR_NOPLAYERS
- There are no active players in the session.
- DPERR_NOSESSIONS
- There are no existing sessions for this game.
- DPERR_NOTLOBBIED
- Returned by the IDirectPlayLobby2::Connect method if the application was not started by using the IDirectPlayLobby2::RunApplication method or if there is no DPLCONNECTION structure currently initialized for this DirectPlayLobby object.
- DPERR_NOTLOGGEDIN
- An action cannot be performed because a player or client application is not logged in. Returned by the IDirectPlay3::Send method when the client application tries to send a secure message without being logged in.
- DPERR_OUTOFMEMORY
- There is insufficient memory to perform the requested operation.
- DPERR_PLAYERLOST
- A player has lost the connection to the session.
- DPERR_SENDTOOBIG
- The message being sent by the IDirectPlay3::Send method is too large.
- DPERR_SESSIONLOST
- The connection to the session has been lost.
- DPERR_SIGNFAILED
- The requested information could not be digitally signed. Digital signatures are used to establish the authenticity of messages.
- DPERR_TIMEOUT
- The operation could not be completed in the specified time.
- DPERR_UNAVAILABLE
- The requested function is not available at this time.
- DPERR_UNINITIALIZED
- The requested object has not been initialized.
- DPERR_UNKNOWNAPPLICATION
- An unknown application was specified.
- DPERR_UNSUPPORTED
- The function is not available in this implementation. Returned from IDirectPlay3::GetGroupConnectionSettings and IDirectPlay3::SetGroupConnectionSettings if they are called from a session that is not a lobby session.
- DPERR_USERCANCEL
- Can be returned in two ways. 1) The user canceled the connection process during a call to the IDirectPlay3::Open method. 2) The user clicked Cancel in one of the DirectPlay service provider dialog boxes during a call to IDirectPlay3::EnumSessions.
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.