IDirectPlay8Server::SetSPCaps メソッド

  • [アーティクル]

IDirectPlay8Server::SetSPCaps メソッド

指定されたサービス プロバイダに対する DPN_SP_CAPS 構造体を設定する。

構文

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

パラメータ

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

戻り値

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

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

注意

このメソッドは、指定されたサービス プロバイダに対するパラメータを設定する。IDirectPlay8Server::Initialize の呼び出しが成功した後に、このメソッドを呼び出す必要がある。現在、この呼び出しでは dwSystemBufferSize メンバのみ設定できる。dwNumThreads メンバはレガシー サポート用である。Microsoft DirectX® 9.0 アプリケーションは、IDirectPlay8ThreadPool::SetThreadCount メソッドを使ってスレッド数を設定する必要がある。DPN_SP_CAPS 構造体の他のメンバは取得専用か無視される。