DPLMSG_SETPROPERTYRESPONSE

The DPLMSG_SETPROPERTYRESPONSE message is sent by a lobby to an application as confirmation of a DPLMSG_SETPROPERTY message. The message that is being confirmed is identified by the dwRequestID member.

typedef struct {
    DWORD    dwType;
    DWORD    dwRequestID
    GUID     guidPlayer;
    GUID     guidPropertyTag;
    HRESULT  hr;
} DPLMSG_SETPROPERTYRESPONSE, FAR *LPDPLMSG_SETPROPERTYRESPONSE;

dwType

Identifies the message. This value is DPLSYS_SETPROPERTYRESPONSE.

dwRequestID

The ID that identifies the DPLMSG_SETPROPERTY message being confirmed.

guidPlayer

GUID identifying the player that this property was set for (if applicable). If the property is not player-specific, this member is GUID_NULL. This must be the same as the GUID from the DPLMSG_SETPROPERTY message.

guidPropertyTag

A GUID identifying the property that was set. This must be the same as the GUID from the DPLMSG_SETPROPERTY message.

hr

Result of the confirmation. One of the following values:

DP_OK

The property was set correctly.

DPERR_ACCESSDENIED

An attempt was made to set a property the lobby will not allow to be changed.

DPERR_UNKNOWNMESSAGE

The property is unknown to the lobby.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in dplobby.h.

See Also

DPLMSG_SETPROPERTY