DPN_MSGID_ENUM_HOSTS_RESPONSE

Microsoft® DirectPlay® sends the DPN_MSGID_ENUM_HOSTS_RESPONSE message to a peer or client's message handler to convey the host's response to an enumeration request.

DPNMSG_ENUM_HOSTS_RESPONSE

The DPNMSG_ENUM_HOSTS_RESPONSE structure contains information for the DPN_MSGID_ENUM_HOSTS_RESPONSE system message.

typedef struct _DPNMSG_ENUM_HOSTS_RESPONSE{
    DWORD                         dwSize;
    IDirectPlay8Address*          pAddressSender;
    IDirectPlay8Address*          pAddressDevice;
    const DPN_APPLICATION_DESC*   pApplicationDescription;
    PVOID                         pvResponseData;
    DWORD                         dwResponseDataSize;
    PVOID                         pvUserContext;
    DWORD                         dwRoundTripLatencyMS;
} DPNMSG_ENUM_HOSTS_RESPONSE, *PDPNMSG_ENUM_HOSTS_RESPONSE;

dwSize

Size of this structure.

pAddressSender

Pointer to an IDirectPlay8Address interface specifying the address of the host responding to the enumeration. You must call IDirectPlay8Address::AddRef to increment the interface's reference count. Call IDirectPlay8Address::Release when you no longer need the interface.

pAddressDevice

Pointer an IDirectPlay8Address interface specifying the address of the device. You must call IDirectPlay8Address::AddRef to increment the interface's reference count. Call IDirectPlay8Address::Release when you no longer need the interface.

pApplicationDescription

Pointer to a DPN_APPLICATION_DESC structure containing the application description.

pvResponseData

Pointer to the response data from the enumeration.

dwResponseDataSize

Size of the data pointed to in the pvResponseData member.

pvUserContext

Pointer to the user context value. This value is the same as the user context value passed to IDirectPlay8Peer::EnumHosts or IDirectPlay8Client::EnumHosts.

dwRoundTripLatencyMS

Latency measured in milliseconds.

Return Values

Return DPN_OK to continue the host enumeration.

Return any other value to stop the host enumeration.

Remarks

Because there is no buffer to fill, this message does not generate a DPN_MSGID_RETURN_BUFFER message.

Requirements

  Windows NT/2000/XP: Available as a redistributable for Windows 2000 and later.
  Windows 98/Me: Available as a redistributable for Windows 98 and later.
  Header: Declared in Dplay8.h.