共用方式為

GetOwnerModuleFromUdp6Entry 函式 (iphlpapi.h)

  • 發行項

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

語法

IPHLPAPI_DLL_LINKAGE DWORD GetOwnerModuleFromUdp6Entry(
  [in]      PMIB_UDP6ROW_OWNER_MODULE     pUdpEntry,
  [in]      TCPIP_OWNER_MODULE_INFO_CLASS Class,
  [out]     PVOID                         pBuffer,
  [in, out] PDWORD                        pdwSize
);

參數

[in] pUdpEntry

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

[in] Class

TCPIP_OWNER_MODULE_INFO_CLASS 列舉值，指出要取得的擁有者模組相關資料類型。

[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 參數中傳回，而且必須在後續呼叫此函式時使用，才能成功擷取資料表。

備註

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

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

對於在 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