DPN_MSGID_ENUM_HOSTS_RESPONSE Message

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.

The DPNMSG_ENUM_HOSTS_RESPONSE structure contains information for the DPN_MSGID_ENUM_HOSTS_RESPONSE system message.

Syntax

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;

Members

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.

Remarks

Return from the message callback function with DPN_OK.

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

Message Information

Header	dplay8.h
Minimum operating systems	Windows 98, Pocket PC 2002