Fungsi GetOwnerModuleFromUdpEntry (iphlpapi.h)

Artikel
08/24/2023

Fungsi GetOwnerModuleFromUdpEntry mengambil data tentang modul yang mengeluarkan ikatan konteks untuk titik akhir UDP IPv4 tertentu dalam baris tabel MIB.

Sintaks

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

Parameter

[in] pUdpEntry

Penunjuk ke struktur MIB_UDPROW_OWNER_MODULE yang berisi entri titik akhir UDP IPv4 yang digunakan untuk mendapatkan modul pemilik.

[in] Class

Nilai enumerasi TCPIP_OWNER_MODULE_INFO_CLASS yang menunjukkan jenis data yang akan diperoleh mengenai modul pemilik.

[out] pBuffer

Buffer yang berisi struktur TCPIP_OWNER_MODULE_BASIC_INFO dengan data modul pemilik. Jenis data yang dikembalikan dalam buffer ini ditunjukkan oleh nilai parameter Kelas .

Struktur berikut digunakan untuk data di Buffer saat Kelas diatur ke nilai yang sesuai.

Nilai enumerasi kelas	Format data buffer
TCPIP_OWNER_MODULE_BASIC_INFO	TCPIP_OWNER_MODULE_BASIC_INFO

[in, out] pdwSize

Perkiraan ukuran, dalam byte, dari struktur yang dikembalikan dalam Buffer. Jika nilai ini diatur terlalu kecil, ERROR_INSUFFICIENT_BUFFER dikembalikan oleh fungsi ini, dan bidang ini akan berisi ukuran struktur yang benar.

Nilai kembali

Jika panggilan berhasil, nilai NO_ERROR dikembalikan. Jika tidak, kesalahan berikut dikembalikan.

Menampilkan kode	Deskripsi
ERROR_INSUFFICIENT_BUFFER	Ruang tidak cukup dialokasikan untuk tabel. Ukuran tabel dikembalikan dalam parameter pdwSize , dan harus digunakan dalam panggilan berikutnya ke fungsi ini agar berhasil mengambil tabel.

Keterangan

Parameter Buffer tidak hanya berisi struktur dengan pointer ke data tertentu, misalnya, pointer ke string yang dihentikan nol yang berisi nama dan jalur modul pemilik, tetapi juga data aktual itu sendiri; yaitu string nama dan jalur. Oleh karena itu, saat menghitung ukuran buffer, pastikan Anda memiliki cukup ruang untuk struktur serta data yang ditunjukkan oleh anggota struktur.

Resolusi entri tabel UDP ke modul pemilik adalah praktik terbaik. Dalam beberapa kasus, nama modul pemilik yang dikembalikan dalam struktur TCPIP_OWNER_MODULE_BASIC_INFO dapat menjadi nama proses, seperti "svchost.exe", nama layanan, seperti "RPC", atau nama komponen, seperti "timer.dll".

Untuk komputer yang berjalan pada Windows Vista atau yang lebih baru, mengakses anggota pModuleName dan pModulePath dari struktur TCPIP_OWNER_MODULE_BASIC_INFO dibatasi oleh kontrol akun pengguna (UAC). Jika aplikasi yang memanggil fungsi ini dijalankan oleh pengguna yang masuk sebagai anggota grup Administrator selain Administrator bawaan, panggilan ini akan berhasil tetapi akses ke anggota ini mengembalikan string kosong kecuali aplikasi telah ditandai dalam file manifes dengan requestedExecutionLevel diatur ke requireAdministrator. Jika aplikasi di Windows Vista atau yang lebih baru tidak memiliki file manifes ini, pengguna yang masuk sebagai anggota grup Administrator selain Administrator bawaan kemudian harus menjalankan aplikasi dalam shell yang ditingkatkan sebagai Administrator bawaan (administrator RunAs) agar akses ke anggota pModuleName dan pModulePath yang dilindungi diizinkan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista, Windows XP dengan SP2 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008, Windows Server 2003 dengan SP1 [hanya aplikasi desktop]
Target Platform	Windows
Header	iphlpapi.h
Pustaka	Iphlpapi.lib
DLL	Iphlpapi.dll

Bagikan melalui