IDirectPlay8NATResolver::Initialize メソッド

IDirectPlay8NATResolver::Initialize メソッド

IDirectPlay8NATResolver インターフェイスを初期化する。このメソッドを呼び出してから、このインターフェイスのその他のメソッドを呼び出す必要がある。

構文

HRESULT Initialize(      
    const PVOID pvUserContext,
    const PFNDPNMESSAGEHANDLER pfn,
    const DWORD dwFlags
);

パラメータ

• pvUserContext
  [in] メッセージ ハンドラの呼び出しで指定される、ユーザー指定のコンテキスト値。ユーザー指定のコンテキスト値を使うと、複数のインターフェイスから共通のメッセージ ハンドラに送信されたメッセージを区別できる。
• pfn
  [in] すべてのメッセージの受信に使われる PFNDPNMESSAGEHANDLER コールバック関数へのポインタ。
• dwFlags
  [in] 次のフラグを設定できる。
  • DPNINITIALIZE_DISABLEPARAMVAL
    このフラグを渡すと、現在のオブジェクトに対するパラメータ妥当性の検証が無効になる。

戻り値

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

DPNERR_ALREADYINITIALIZED	オブジェクトは既に初期化されている。
DPNERR_INVALIDFLAGS	このメソッドに渡されたフラグは無効である。
DPNERR_INVALIDOBJECT	Microsoft® DirectPlay® オブジェクトのポインタは無効である。
DPNERR_INVALIDPARAM	メソッドに渡された 1 つ以上のパラメータが無効である。