IDirectPlay4::SetPlayerName

---

IDirectPlay4 Interface

Sets the name of a local player after it has been changed. Only the computer that created the player can change the name. A DPMSG_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.

Syntax

HRESULT SetPlayerName(
  DPID idPlayer,
  LPDPNAME lpPlayerName,
  DWORD dwFlags
  );

Parameters

idPlayer

ID of the local player for which data is being sent.

lpPlayerName

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

dwFlags

Flags indicating how the name will be propagated. It can be one of the following values:

DPSET_GUARANTEED

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

DPSET_LOCAL

Data is not propagated to other players.

DPSET_REMOTE

Propagates the data to all players in the session using nonguaranteed message passing. This is the default value.

Return Value

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

DPERR_CONNECTIONLOST

DPERR_INVALIDOBJECT

DPERR_INVALIDPLAYER

See Also

DPNAME, DPMSG_SETPLAYERORGROUPNAME, IDirectPlay4::GetPlayerName, IDirectPlay4::Send

---

 Top of Page
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.