Platform SDK: DirectX |
DirectXRegisterApplication 関数は、アプリケーションを DirectPlayLobby 対応アプリケーションとして登録する。
int WINAPI DirectXRegisterApplication( HWND hWnd, LPDIRECTXREGISTERAPP lpDXRegApp );
成功すれば TRUE を返す。失敗すれば FALSE を返す。GetLastError 関数を使用すると、拡張エラー情報を取得できる。
DirectXRegisterApplication 関数では、システムにインストールされていない dsetup.dll と dsetup32.dll の両方が必要となるが、両方共 SDK に準備されている。
DirectXRegisterApplication 関数は、アプリケーションが DirectPlayLobby で動作するのに必要なレジストリ エントリを挿入するが、ロビー アプリケーションのインストールとアンインストールには、IDirectPlayLobby3::RegisterApplication と IDirectPlayLobby3::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 を使用。