Microsoft DirectX 8.0 (C++)

IDirectPlay8Server::Host

ローカル コンピュータによってホストされる、新しいクライアント/サーバー セッションを作成する。

HRESULT Host(
const DPN_APPLICATION_DESC *const pdnAppDesc,
IDirectPlay8Address **const prgpDeviceInfo,
const DWORD cDeviceInfo,
const DPN_SECURITY_DESC *const pdpSecurity,
const DPN_SECURITY_CREDENTIALS *const pdpCredentials,
VOID *const pvPlayerContext,
const DWORD dwFlags
);

パラメータ

pdnAppDesc
アプリケーションを記述する DPN_APPLICATION_DESC 構造体へのポインタ。
prgpDeviceInfo
アプリケーションをホストするために使用するデバイス アドレスを保持する、IDirectPlay8Address オブジェクトの配列へのポインタ。
cDeviceInfo
prgpDeviceInfo が示す配列のデバイス アドレス オブジェクトの数を指定する DWORD 型の変数。
pdpSecurity
予約済み。NULL に設定すること。
pdpCredentials
予約済み。NULL に設定すること。
pvPlayerContext
プレーヤーのコンテキスト値へのポインタ。この値は、ローカル コンピュータが DPN_MSGID_CREATE_PLAYER メッセージを処理するときに、事前に設定される。このパラメータはオプションであり、NULL に設定できる。
dwFlags
次のフラグを指定できる。
DPNHOST_OKTOQUERYFORADDRESSING
このフラグを設定すると、Microsoft® DirectPlay® の標準のダイアログ ボックスが表示される。十分な情報がこのメソッドに渡されていない場合は、詳細について問い合わされる。

戻り値

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

DPNERR_DATATOOLARGE
DPNERR_INVALIDPARAM

注意

dwFlags に DPNHOST_OKTOQUERYFORADDRESSING フラグを設定した場合、サービス プロバイダは、ダイアログ ボックスを表示して、ユーザーにアドレス情報の入力を求めようとする。サービス プロバイダがダイアログ ボックスの表示を試みるときには、表示可能なウィンドウが存在している必要がある。ウィンドウがない場合、アプリケーションはロックする。

DPN_APPLICATION_DESC 構造体の pvApplicationReservedData メンバに割り当てるアプリケーション データの最大サイズは、サービス プロバイダの Maximum Transmission Unit によって制限される。アプリケーション データが大きすぎる場合、メソッドは失敗し、DPNERR_DATATOOLARGE を返す。

動作環境

  Windows NT/2000 : Windows 2000 以降に対する再配布可能ファイルとして提供。
  Windows 95/98 : Windows 95 以降に対する再配布可能ファイルとして提供。
  ヘッダー : Dplay8.h で宣言。