CreateHandoffTable 関数

CreateHandoffTable 関数は、パーサーの INI ファイルに格納されているハンドオフ セット情報を含むハンドオフ テーブルを作成します。

構文

DWORD WINAPI CreateHandoffTable(
  _In_  LPSTR          secName,
  _In_  LPSTR          iniFile,
  _Out_ LPHANDOFFTABLE *hTable,
  _In_  DWORD          nMaxProtocolEntries,
  _In_  DWORD          base
);

パラメーター

secName [in]

ハンドオフ セット情報が配置されている INI ファイルのセクションを示す文字列。

iniFile [in]

パーサー INI ファイルの名前を含む文字列。

hTable [out]

ネットワーク モニターによって作成および管理される HANDOFFTABLE 構造体へのハンドル。

nMaxProtocolEntries [in]

ハンドオフ テーブルで処理できるエントリの最大数を指定する数値。

base [in]

INI ファイルに格納されているハンドオフ セット番号の数値ベース。

戻り値

関数が成功した場合、戻り値はハンドオフ テーブル内のエントリの数です。

関数が失敗した場合、戻り値は 0 です。

解説

Network Monitor によって作成されるハンドオフ テーブルは、パーサー INI で提供される情報に基づいています。 ハンドオフ テーブルに返されたハンドルを使用して、テーブルに含まれるプロトコルの 1 つに対するハンドルを取得できます。 これらのプロトコルの 1 つのハンドルを取得するには、 GetProtocolFromTable を呼び出します。

パーサー アプリケーションが HANDOFFTABLE 構造体に直接アクセスすることはありません。 この構造は、ネットワーク モニターによって作成および管理されます。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
ヘッダー	Netmon.h
ライブラリ	Nmapi.lib
[DLL]	Nmapi.dll

関連項目

GetProtocolFromTable

HANDOFFTABLE