IDirectPlay8Server::SetCaps メソッド

  • [アーティクル]

IDirectPlay8Server::SetCaps メソッド

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

構文

HRESULT SetCaps(      
    const DPNCAPS *const pdpCaps,
    const DWORD dwFlags
);

パラメータ

  • pdpCaps
    [in] 現在のインターフェイスに関する情報の設定に使う DPN_CAPS または DPN_CAPS_EX 構造体へのポインタ。
  • dwFlags
    [in] 予約済み。0 でなければならない。

戻り値

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

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

注意

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

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