CreateProtocol 関数

CreateProtocol 関数は、特定のプロトコルパーサーが存在することをネットワークモニターに通知します。

構文

HPROTOCOL WINAPI CreateProtocol(
  _In_ LPSTR         ProtocolName,
  _In_ LPENTRYPOINTS lpEntryPoints,
  _In_ DWORD         cbEntryPoints
);

ProtocolName [in]: パーサーが検出するプロトコルの名前。
lpEntryPoints [in]: 残りのパーサー DLL エントリポイントを含む ENTRYPOINTS 構造体。各エントリポイントが参照するエクスポート関数の一覧については、「解説」を参照してください。エントリポイントは、 ENTRYPOINTS 構造体が指定する順序で指定する必要があります。
cbEntryPoints [in]: ENTRYPOINTS 構造体のサイズ。 Network Monitor には、構造のサイズを指定するために使用できるENTRYPOINTS_SIZEマクロが用意されています。

関数が成功した場合、戻り値はプロトコルへのハンドルです。

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

パーサー DLL は、DllMain の実装中に CreateProtocol を呼び出します。 CreateProtocol 関数は、オペレーティングシステムがパーサー DLL を初めて読み込むときに呼び出されます。

lpEntryPoints パラメーターで参照されるエントリポイントには、ここに示す順序で指定する必要がある次のエクスポート関数へのポインターが含まれます。

情報	参照先
パーサーとは何か、およびネットワークモニターで動作する方法。	パーサー
DllMain を実装する方法には、 DllMain 内で CreateProtocol を呼び出す例が含まれています。	DllMain の実装

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