CreatePropertyDatabase 関数

CreatePropertyDatabase 関数は、プロトコルのプロパティを格納するプロパティ データベースを作成します。

構文

DWORD WINAPI CreatePropertyDatabase(
  _In_ HPROTOCOL hProtocol,
  _In_ DWORD     nProperties
);

パラメーター

hProtocol [in]

データベースに関連付けられているプロトコルのハンドル。 ネットワーク モニターが Register 関数を呼び出すと、ネットワーク モニターはプロトコル ハンドルをパーサー DLL に渡します。

nProperties [in]

データベースに格納されているプロパティの数。 このパラメーターを、プロトコルがサポートするプロパティの数に設定します。

戻り値

関数が成功した場合、戻り値はNMERR_SUCCESS。

関数が失敗した場合、戻り値はエラー コードになります。

リターン コード	説明
NMERR_INTERNAL_ERROR	内部エラーが発生しました。
NMERR_INVALID_HPOTOCOL	hProtocol で指定されたプロトコルのハンドルが無効です。
NMERR_OUT_OF_MEMORY	ネットワーク モニターには、データベースを作成するための十分なメモリがありません。

解説

CreatePropertyDatabase 関数は、Register 関数を実装する場合にのみ呼び出す必要があります。 パーサーは 、CreatePropertyDatabase を使用して、プロトコルのプロパティを記述するプロパティ データベースを作成します。 Network Monitor は、データベースを使用してプロトコル内の情報を解釈します。

CreatePropertyDatabase 関数は、ネットワーク モニターがプロパティ データベースを維持するために必要な構造体を割り当てます。

要件

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

関連項目

[登録]