IDirectPlay8Client::GetSPCaps メソッド

IDirectPlay8Client::GetSPCaps メソッド

指定されたサービス プロバイダの DPN_SP_CAPS 構造体を取得する。

構文

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

パラメータ

• pguidSP
  [in] 情報を取得したいサービス プロバイダを指定するグローバル一意識別子 (GUID) へのポインタ。
• pdpnSPCaps
  [out] 指定したサービス プロバイダに関する情報を受け取る DPN_SP_CAPS 構造体へのポインタ。pdpnSPCaps.dwSize メンバを DPN_SP_CAPS 構造体のサイズに設定しなければならない。
• dwFlags
  [in] 予約済み。0 でなければならない。

戻り値

成功した場合は S_OK を返し、失敗した場合は次のいずれかのエラー値を返す。

DPNERR_INVALIDOBJECT	Microsoft® DirectPlay® オブジェクトのポインタは無効である。
DPNERR_INVALIDPARAM	メソッドに渡された 1 つ以上のパラメータが無効である。
DPNERR_INVALIDPOINTER	パラメータとして指定されたポインタが無効である。
DPNERR_UNINITIALIZED	要求されたオブジェクトが初期化されていない。

注意

このメソッドは、指定したサービス プロバイダに関する情報を取得する。IDirectPlay8Client::Initialize の呼び出しが成功した後に、このメソッドを呼び出す必要がある。