Platform SDK: DirectX

DirectXRegisterApplication

DirectXRegisterApplication 関数は、アプリケーションを DirectPlayLobby 対応アプリケーションとして登録する。

int WINAPI DirectXRegisterApplication(
  HWND hWnd,                       
  LPDIRECTXREGISTERAPP lpDXRegApp  
);

パラメータ

hWnd
親ウィンドウのハンドル。このパラメータが NULL の場合は、デスクトップが親ウィンドウとなる。
lpDXRegApp
DirectPlayLobby で正しくアプリケーションを動作させるために必要なレジストリ エントリを含む DIRECTXREGISTERAPP 構造体のアドレス。

戻り値

成功すれば TRUE を返す。失敗すれば FALSE を返す。GetLastError 関数を使用すると、拡張エラー情報を取得できる。

注意

DirectXRegisterApplication 関数では、システムにインストールされていない dsetup.dll と dsetup32.dll の両方が必要となるが、両方共 SDK に準備されている。

DirectXRegisterApplication 関数は、アプリケーションが DirectPlayLobby で動作するのに必要なレジストリ エントリを挿入するが、ロビー アプリケーションのインストールとアンインストールには、IDirectPlayLobby3::RegisterApplicationIDirectPlayLobby3::UnregisterApplication の各メソッドの使用を推奨する。そのため、DirectXRegisterApplication を使用した場合、アプリケーションのアンインストール時には、DirectXUnRegisterApplication でこれらのレジストリ エントリを削除する必要がある。

市販されているインストール プログラムの多くは、プログラムのアンインストール時にレジストリ エントリを自動的に削除する。ただし、これは、プログラム自体がレジストリ エントリを追加した場合に限られる。DirectXRegisterApplication によって DirectPlayLobby のレジストリ エントリが追加された場合は、市販のインストール プログラムでアンインストールしても、レジストリ エントリが削除されない。したがって、DirectXRegisterApplication によって作成された DirectPlayLobby のレジストリ エントリは、DirectXUnRegisterApplication を使って削除しなければならない。

DirectPlayLobby アクセスに必要なレジストリ エントリは、DirectXRegisterApplication を使用しなくても作成できる。ただし、この方法は一般に推奨されるものではない。Microsoft® DirectPlay® の「ロビー対応アプリケーションの登録」を参照すること。

動作環境

  Windows NT/2000 : Windows 2000 が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  ヘッダー : dsetup.h で宣言。
  インポート ライブラリ : dsetup.lib を使用。

参照

DirectXUnRegisterApplication