IDirectPlay8Peer::SetCaps Method

Sets the DPN_CAPS or DPN_CAPS_EX structure for the current interface.

Syntax

HRESULT SetCaps(      

    const DPN_CAPS *const pdpCaps,
    const DWORD dwFlags
);

Parameters

pdpCaps

[in] Pointer to a DPN_CAPS or DPN_CAPS_EX structure used to set the information about the current interface.

dwFlags

[in] Reserved. Must be 0.

Return Value

Returns S_OK if successful, or one of the following error values.

DPNERR_INVALIDOBJECT	The Microsoft® DirectPlay® object pointer is invalid.
DPNERR_INVALIDPARAM	One or more of the parameters passed to the method are invalid.
DPNERR_INVALIDPOINTER	Pointer specified as a parameter is invalid.
DPNERR_UNINITIALIZED	The requested object has not been initialized.

Remarks

A successful call to IDirectPlay8Peer::Initialize must be made before this method can be called.

DirectPlay will determine whether DPN_CAPS or DPN_CAPS_EX is being used based on the size of the structure referenced by pdpCaps.