GetOwnerModuleFromTcp6Entry

MIB テーブル行内の特定の IPv6 TCP エンドポイントに対してコンテキストバインドを発行したモジュールに関するデータを取得する。

GetOwnerModuleFromTcp6Entry pTcpEntry, Class, pBuffer, pdwSize

pTcpEntry : [var] 所有モジュールの取得に用いる IPv6 TCP エンドポイントエントリを含む MIB_TCP6ROW_OWNER_MODULE 構造体へのポインタ。
Class : [int] 所有モジュールに関して取得するデータの種別を示す TCPIP_OWNER_MODULE_INFO_CLASS 列挙値。TCPIP_OWNER_MODULE_INFO_CLASS 列挙体は Iprtrmib.h ヘッダファイルで定義される。このパラメータには TCPIP_OWNER_MODULE_INFO_BASIC を設定しなければならない。
pBuffer : [intptr] 所有モジュールのデータを格納した TCPIP_OWNER_MODULE_BASIC_INFO 構造体を含むバッファへのポインタ。このバッファに返されるデータの種別は Class パラメータの値で示される。Class に各値が設定されたとき、Buffer のデータには以下の構造体が用いられる。
pdwSize : [var] Buffer に返される構造体の推定サイズ (バイト単位)。この値が小さすぎる場合、関数は ERROR_INSUFFICIENT_BUFFER を返し、このフィールドには正しい構造体サイズが格納される。

(プラグイン / モジュール : iphlpapi.dll)

解説

MIB テーブル行内の特定の IPv6 TCP エンドポイントに対してコンテキストバインドを発行したモジュールに関するデータを取得する。

[戻り値]
関数呼び出しが成功すると、値 NO_ERROR が返される。関数が失敗した場合、戻り値は以下のエラーコードのいずれかである。
このドキュメントは省略されている。

[備考]
Buffer パラメータには、特定のデータへのポインタ (例えば所有モジュール名とパスを含むゼロ終端文字列へのポインタ)
を持つ構造体だけでなく、実際のデータそのもの (すなわち名前とパス文字列)
が格納される。したがってバッファサイズを計算する際は、構造体自体と、そのメンバが指すデータの双方に十分な領域を確保すること。TCP
テーブルエントリを所有モジュールに解決することはベストプラクティスであるが、TCPIP_OWNER_MODULE_BASIC_INFO
に返される所有モジュール名はプロセス名 ("svchost.exe" など)、サービス名 ("RPC" など)、コンポーネント名
("timer.dll" など) のいずれかになる場合がある。Windows Vista
以降では、TCPIP_OWNER_MODULE_BASIC_INFO の pModuleName / pModulePath メンバが一部
TCP 接続で空文字列を指すことがある。Windows システムフォルダ (既定では C:\Windows\System32)
に配置されたアプリケーションが開始した TCP 接続は保護されており、Administrators
グループのメンバでないユーザが呼び出した場合は関数自体は成功するものの、保護されたアプリケーションが開始した接続の pModuleName
/ pModulePath は空文字列を指すメモリとなる。また、UAC の影響により、組み込み Administrator 以外の
Administrators グループメンバが実行する場合、マニフェストで requestedExecutionLevel が
requireAdministrator に設定されていないと、これらのメンバは空文字列を返す。マニフェストがない場合は、RunAs
administrator で実行された拡張シェルから起動する必要がある。

情報