IDirectPlay8Client::GetSPCaps Method

Retrieves the DPN_SP_CAPS structure for the specified service provider.

Syntax

HRESULT GetSPCaps(      
    const GUID *const pguidSP,
    DPN_SP_CAPS *const pdpnSPCaps,
    const DWORD dwFlags
);

Parameters

pguidSP

[in] Pointer to a globally unique identifier (GUID) specifying the service provider you want to get information about.

pdpnSPCaps

[out] Pointer to a DPN_SP_CAPS structure to receive the information about the specified service provider. You must set the pdpnSPCaps.dwSize member to the size of a DPN_SP_CAPS structure.

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

This method retrieves information about the specified service provider. A successful call to IDirectPlay8Client::Initialize must be made before this method can be called.