IDirectPlay8Client::GetCaps メソッド

IDirectPlay8Client::GetCaps メソッド

現在のインターフェイスの DPN_CAPS または DPN_CAPS_EX 構造体を取得する。

構文

HRESULT GetCaps(      
    DPN_CAPS *const pdpnCaps,
    const DWORD dwFlags
);

パラメータ

• pdpnCaps
  [out] Caps 情報を受け取る DPN_CAPS または DPN_CAPS_EX 構造体。この構造体の dwSize メンバには適切な値を設定する必要がある。
• dwFlags
  [in] 予約済み。0 でなければならない。

戻り値

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

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

注意

IDirectPlay8Client::Initialize の呼び出しが成功した後に、このメソッドを呼び出す必要がある。

DirectPlay は、pdpnCaps が参照する構造体のサイズに基づいて DPN_CAPS または DPN_CAPS_EX が使われているかどうかを判断する。