共用方式為

GetOwnerModuleFromTcp6Entry 函式 (iphlpapi.h)

  • 發行項

GetOwnerModuleFromTcp6Entry函式會擷取針對 MIB 資料表資料列中特定 IPv6 TCP 端點發出內容系結之模組的相關資料。

語法

IPHLPAPI_DLL_LINKAGE DWORD GetOwnerModuleFromTcp6Entry(
  [in]      PMIB_TCP6ROW_OWNER_MODULE     pTcpEntry,
  [in]      TCPIP_OWNER_MODULE_INFO_CLASS Class,
  [out]     PVOID                         pBuffer,
  [in, out] PDWORD                        pdwSize
);

參數

[in] pTcpEntry

MIB_TCP6ROW_OWNER_MODULE結構的指標，其中包含用來取得擁有者模組的 IPv6 TCP 端點專案。

[in] Class

TCPIP_OWNER_MODULE_INFO_CLASS列舉值，指出要取得的擁有者模組相關資料類型。 TCPIP_OWNER_MODULE_INFO_CLASS列舉定義于Iprtrmib.h標頭檔中。

此參數必須設定為 TCPIP_OWNER_MODULE_INFO_BASIC。

[out] pBuffer

緩衝區的指標，其中包含具有擁有者模組資料的 TCPIP_OWNER_MODULE_BASIC_INFO 結構。 此緩衝區中傳回的資料型別是由 Class 參數的值表示。

當Class設定為對應的值時，下列結構會用於Buffer中的資料。

類別 列舉值 緩衝區 資料格式
TCPIP_OWNER_MODULE_BASIC_INFO TCPIP_OWNER_MODULE_BASIC_INFO

[in, out] pdwSize

Buffer中傳回之結構的估計大小，以位元組為單位。 如果此值設定太小， 則此 函式會傳回ERROR_INSUFFICIENT_BUFFER，而且此欄位將包含正確的結構大小。

傳回值

如果函式呼叫成功，則會傳回 NO_ERROR 值。

如果函式失敗，傳回值就是下列其中一個錯誤碼。

傳回碼 描述
ERROR_INSUFFICIENT_BUFFER
 為數據表配置的空間不足。 資料表的大小會在 pdwSize 參數中傳回，而且必須在後續呼叫此函式時使用，才能成功擷取資料表。
ERROR_INVALID_PARAMETER
 參數不正確。 如果 pTcpEntry 或 pdwSize 參數為 Null，則會傳回此值。 如果 Class 參數不等於 TCPIP_OWNER_MODULE_INFO_BASIC，也會傳回此值。
ERROR_NOT_ENOUGH_MEMORY
 可用的記憶體不足，無法完成作業。
ERROR_NOT_FOUND
 找不到元素。 如果pTcpEntry參數所指向之MIB_TCP6ROW_OWNER_MODULE的dwOwningPid成員為零或找不到，則會傳回這個值。
ERROR_PARTIAL_COPY
 只有部分的要求已完成。

備註

Buffer參數不僅包含具有特定資料指標的結構，例如，包含擁有者模組名稱和路徑之零終止字串的指標，還包含實際資料本身;，也就是名稱和路徑字串。 因此，計算緩衝區的大小時，請確定您有足夠的空間可供結構以及結構成員所指向的資料。

將 TCP 資料表專案解析為擁有者模組是最佳做法。 在少數情況下， TCPIP_OWNER_MODULE_BASIC_INFO結構中 傳回的擁有者模組名稱可以是進程名稱 (，例如 「svchost.exe」) 、服務名稱 (例如 「RPC」) ，或元件名稱 (例如 「timer.dll」) 。

對於在 Windows Vista 或更新版本上執行的電腦，GetOwnerModuleFromTcpEntry函式所擷取之TCPIP_OWNER_MODULE_BASIC_INFO的pModuleName和pModulePath成員可能會指向某些 TCP 連線的空字串。 根據預設，啟動位於 Windows 系統資料夾 (C：\Windows\System32 中 TCP 連線的應用程式會被視為受保護) 。 如果GetOwnerModuleFromTcpEntry函式是由不是 Administrators 群組成員的使用者呼叫，則函式呼叫將會成功，但pModuleName 和 pModulePath成員會指向記憶體，其中包含受保護應用程式所啟動之 TCP 連線的空字串。

對於在 Windows Vista 或更新版本上執行的電腦，存取TCPIP_OWNER_MODULE_BASIC_INFO結構的pModuleName 和 pModulePath成員會受限於使用者帳戶控制 (UAC) 。 如果呼叫此函式的應用程式是由使用者以系統管理員群組的成員身分登入，但此呼叫會成功，但存取這些成員會傳回空字串，除非應用程式已在資訊清單檔案中標示 requestedExecutionLevel 設定為 requireAdministrator。 如果 Windows Vista 或更新版本上的應用程式缺少此資訊清單檔案，則以系統管理員群組成員身分登入的使用者必須接著在增強殼層中執行應用程式，因為內建系統管理員 (RunAs 系統管理員) ，才能存取受保護的 pModuleName 和 pModulePath 成員。

需求

   
最低支援的用戶端 Windows Vista、Windows XP SP2 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008、Windows Server 2003 SP1 [僅限傳統型應用程式]
目標平台 Windows
標頭 iphlpapi.h
程式庫 Iphlpapi.lib
Dll Iphlpapi.dll

另請參閱

MIB_TCP6ROW_OWNER_MODULE

TCPIP_OWNER_MODULE_INFO_CLASS