次の方法で共有

IDirectPlay8LobbiedApplication::RegisterProgram メソッド

  • [アーティクル]

IDirectPlay8LobbiedApplication::RegisterProgram メソッド

ロビー起動可能アプリケーションを Microsoft® DirectPlay® に登録する。ロビーによる起動を可能にするには、アプリケーションを登録する必要がある。

構文

HRESULT RegisterProgram(      
    PDPL_PROGRAM_DESC pdplProgramDesc,
    const DWORD dwFlags
);

パラメータ

  • pdplProgramDesc
    [in] 登録するロビーアウェア アプリケーションを記述する DPL_PROGRAM_DESC 構造体へのポインタ。
  • dwFlags
    [in] 予約済み。0 でなければならない。

戻り値

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

DPNERR_INVALIDFLAGS このメソッドに渡されたフラグは無効である。
DPNERR_INVALIDPARAM メソッドに渡された 1 つ以上のパラメータが無効である。

注意

アプリケーションの登録は一度だけ行う必要がある。アプリケーションをアンインストールするとき、IDirectPlay8LobbiedApplication::UnRegisterProgram メソッドを呼び出して登録を解除する必要がある。

IDirectPlay8LobbiedApplication::RegisterProgram を必ず使うこと。アプリケーション情報をレジストリに手動で設定することはできない。このインターフェイスを使わないと、アプリケーションは移植できず、DirectPlay の将来のバージョンと互換性がなくなることがある。

アプリケーションを Microsoft Windows® Powered Pocket PC 2002 上で実行する場合、アプリケーションの実行可能ファイルが Windows ディレクトリ (\Windows) に置かれていない限り、DPL_PROGRAM_DESC 構造体の pwszExecutablePath メンバは NULL に設定しないこと。そのディレクトリではない場合、pwszExecutablePath を正しいパスに設定する。