DPN_APPLICATION_DESC
Microsoft® DirectPlay® アプリケーションの設定を記述する。
typedef struct _DPN_APPLICATION_DESC{
DWORD dwSize;
DWORD dwFlags;
GUID guidInstance;
GUID guidApplication;
DWORD dwMaxPlayers;
DWORD dwCurrentPlayers;
WCHAR* pwszSessionName;
WCHAR* pwszPassword;
PVOID pvReservedData;
DWORD dwReservedDataSize;
PVOID pvApplicationReservedData;
DWORD dwApplicationReservedDataSize;
} DPN_APPLICATION_DESC, *PDPN_APPLICATION_DESC;
メンバ
- dwSize
- DPN_APPLICATION_DESC 構造体のサイズ。アプリケーションは、この構造体を使用する前に、まずこのメンバを設定する必要がある。
- dwFlags
- アプリケーションの動作を記述する次のいずれかのフラグ。
- DPNSESSION_CLIENT_SERVER
- このタイプのセッションはクライアント/サーバーである。このフラグを DPNSESSION_MIGRATE_HOST と組み合わせることはできない。
- DPNSESSION_MIGRATE_HOST
- ピアツーピア セッションで使用され、ホストの移行を可能にする。このフラグを DPNSESSION_CLIENT_SERVER と組み合わせることはできない。
- DPNSESSION_NODPNSVR
- DPNSVR からホストに列挙を転送しない。詳細については、「DirectPlay DPNSVR アプリケーションの使い方」を参照すること。
- DPNSESSION_REQUIREPASSWORD
- セッションをパスワードにより保護する。このフラグを設定した場合、pwszPassword に有効な文字列を指定する必要がある。
- guidInstance
- 起動時に DirectPlay により生成され、このアプリケーションのインスタンスを表すグローバル ユニーク識別子 (GUID)。このメンバは、IDirectPlay8Peer、IDirectPlay8Client、および IDirectPlay8Server インターフェイスで公開される GetApplicationDesc メソッドを呼び出すときの [out] パラメータである。また、IDirectPlay8Peer および IDirectPlay8Client インターフェイスで公開される Connect メソッドを呼び出すときの、オプションの [in] パラメータである。IDirectPlay8Server および IDirectPlay8Peer インターフェイスで公開される SetApplicationDesc メソッドを呼び出すときは、NULL に設定する必要がある。IDirectPlay8Server::Host または IDirectPlay8Peer::Host メソッドを呼び出してこの GUID を取得することはできない。GUID は GetApplicationDesc メソッドを呼び出して取得しなければならない。
- guidApplication
- アプリケーション GUID。
- dwMaxPlayers
- セッションで使用可能なプレーヤーの最大数を指定する DWORD 型の変数。プレーヤーの数を無制限にするときは、このメンバを 0 に設定する。
- dwCurrentPlayers
- セッションに現在接続されているプレーヤーの数を指定する DWORD 型の変数。このメンバは、IDirectPlay8Peer、IDirectPlay8Client、および IDirectPlay8Server で公開される GetApplicationDescription メソッドによってのみ設定される [out] パラメータである。
- pwszSessionName
- セッションの Unicode™ 名を指定する WCHAR 型の変数へのポインタ。このメンバは、情報を伝えるだけの目的でホストまたはサーバーによって設定される。クライアントがこの名前を使用してホストまたはサーバーに接続することはできない。
- pwszPassword
- セッションへの接続に必要な Unicode パスワードを指定する WCHAR 型の変数へのポインタ。dwFlags メンバに DPNSESSION_REQUIREPASSWORD が設定されていない場合、この値は NULL にする必要がある。
- pvReservedData
- DirectPlay の予約済みデータへのポインタ。アプリケーションはこの値を変更してはならない。
- dwReservedDataSize
- pvReservedData メンバに保持されているデータのサイズを指定する DWORD 型の変数。アプリケーションはこの値を変更してはならない。
- pvApplicationReservedData
- アプリケーション固有の予約済みデータへのポインタ。この値はオプションであり、NULL に設定できる。
- dwApplicationReservedDataSize
- pvApplicationReservedData メンバのデータのサイズを指定する DWORD 型の変数。この値はオプションであり、NULL に設定できる。
注意
dwMaxPlayers、pvApplicationReservedData、dwApplicationReservedDataSize、pwszPassword、および pwszSessionName メンバは、IDirectPlay8Server および IDirectPlay8Peer インターフェイスで公開される Host または SetApplicationDesc メソッドを呼び出すときに設定できる。セッション中のプレーヤの現在の数より小さな値で dwMaxPlayers パラメータを設定することはできない。
Windows NT/2000 : Windows 2000 以降に対する再配布可能ファイルとして提供。
Windows 95/98 : Windows 95 以降に対する再配布可能ファイルとして提供。
ヘッダー : Dplay8.h で宣言。