IDirectPlay2::SetPlayerName

HRESULT SetPlayerName(DPID idPlayer,

LPDPNAME lpPlayerName, DWORD dwFlags);

Sets the name of the player after it has been changed. A DPSYS_SETPLAYERORGROUPNAME system message will be sent to all the other players notifying them of the change unless DPSESSION_NODATAMESSAGES is set in the session description. For a list of system messages, see Using System Messages.

·Returns DP_OK if successful, or one of the following error values otherwise:

DPERR_INVALIDOBJECT

DPERR_INVALIDPLAYER

idPlayer

ID of the player for which data is being sent.

lpPlayerName

Address of a DPNAME structure containing the name information for the player. Set this parameter to NULL if the player has no name information.

dwFlags

If this parameter is set to 0, the name will be propagated to all the remote systems using nonguaranteed message passing.

DPSET_GUARANTEED

Propagates the data by using guaranteed messaging (if available).