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.
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:
Propagates the data by using guaranteed messaging (if available).
Data is not propagated to other players.
Propagates the data to all players in the session using nonguaranteed message passing. This is the default value.
Return Values
Returns DP_OK if successful, or one of the following error values otherwise:
See Also
DPNAME, DPMSG_SETPLAYERORGROUPNAME, IDirectPlay3::GetPlayerName, IDirectPlay3::Send