Fungsi WNetGetResourceParentA (winnetwk.h)

Artikel
11/20/2024

Fungsi WNetGetResourceParent mengembalikan induk sumber daya jaringan dalam hierarki penelusuran jaringan. Penjelajahan dimulai di lokasi sumber daya jaringan yang ditentukan.

Panggil WNetGetResourceInformation dan fungsi WNetGetResourceParent untuk meningkatkan hierarki jaringan. Panggil fungsi WNetOpenEnum untuk memindahkan hierarki.

Sintaksis

DWORD WNetGetResourceParentA(
  [in]      LPNETRESOURCEA lpNetResource,
  [out]     LPVOID         lpBuffer,
  [in, out] LPDWORD        lpcbBuffer
);

Parameter

[in] lpNetResource

Penunjuk ke struktur NETRESOURCE yang menentukan sumber daya jaringan yang nama induknya diperlukan.

Tentukan anggota struktur NETRESOURCE sebagai berikut. Pemanggil biasanya mengetahui nilai yang akan disediakan untuk lpProvider dan anggota dwType setelah panggilan sebelumnya ke WNetGetResourceInformation atau WNetGetResourceParent.

Anggota	Arti
dwType	Anggota ini harus diisi jika diketahui; jika tidak, harus diatur ke NULL.
lpRemoteName	Anggota ini harus menentukan nama jarak jauh sumber daya jaringan yang induknya diperlukan.
lpProvider	Anggota ini harus menentukan penyedia jaringan yang memiliki sumber daya. Anggota ini diperlukan; jika tidak, fungsi dapat menghasilkan hasil yang salah.

Semua anggota lain dari struktur NETRESOURCE diabaikan.

[out] lpBuffer

Arahkan ke buffer untuk menerima struktur NETRESOURCE tunggal yang mewakili sumber daya induk. Fungsi mengembalikan lpRemoteName, lpProvider, dwType, dwDisplayType, dan dwUsage anggota struktur; semua anggota lain diatur ke NULL.

Anggota lpRemoteName menunjuk ke nama jarak jauh untuk sumber daya induk. Nama ini menggunakan sintaks yang sama dengan yang dikembalikan dari enumerasi oleh fungsi WNetEnumResource . Pemanggil dapat melakukan perbandingan string untuk menentukan apakah sumber daya WNetGetResourceParent sama dengan yang dikembalikan oleh WNetEnumResource. Jika sumber daya input tidak memiliki induk di salah satu jaringan, anggota lpRemoteName dikembalikan sebagai NULL.

Kehadiran bit RESOURCEUSAGE_CONNECTABLE di dwUsage anggota menunjukkan bahwa Anda dapat terhubung ke sumber daya induk, tetapi hanya ketika tersedia di jaringan.

[in, out] lpcbBuffer

Penunjuk ke lokasi yang, pada entri, menentukan ukuran lpBuffer buffer, dalam byte. Jika buffer terlalu kecil untuk menahan hasilnya, lokasi ini menerima ukuran buffer yang diperlukan, dan fungsi mengembalikan ERROR_MORE_DATA.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah NO_ERROR.

Jika fungsi gagal, nilai yang dikembalikan adalah kode kesalahan sistem , seperti salah satu nilai berikut.

Mengembalikan kode	Deskripsi
ERROR_ACCESS_DENIED	Pemanggil tidak memiliki akses ke sumber daya jaringan.
ERROR_BAD_NET_NAME	Input anggota lpRemoteName bukan sumber daya jaringan yang ada untuk jaringan apa pun.
ERROR_BAD_PROVIDER	Input lpProvider anggota tidak cocok dengan penyedia jaringan yang diinstal.
ERROR_MORE_DATA	Buffer yang ditujukkan oleh parameter lpBuffer terlalu kecil.
ERROR_NOT_AUTHENTICATED	Pemanggil tidak memiliki izin yang diperlukan untuk mendapatkan nama induk.

Komentar

Fungsi WNetGetResourceParent biasanya digunakan bersama dengan fungsi WNetGetResourceInformation untuk mengurai dan menafsirkan jalur jaringan yang ditik oleh pengguna.

Tidak seperti fungsi WNetGetResourceInformation, jika sumber daya menyertakan induk dalam sintaksnya, fungsi WNetGetResourceParent mengembalikan induk, apakah sumber daya benar-benar ada atau tidak. WNetGetResourceParent biasanya hanya boleh digunakan oleh aplikasi yang menampilkan sumber daya jaringan kepada pengguna dengan cara hierarkis. Kotak dialog Windows Explorer dan File Open adalah dua contoh terkenal dari jenis aplikasi ini. Perhatikan bahwa tidak ada asumsi yang harus dibuat tentang jenis sumber daya yang akan dikembalikan.

Anda dapat memanggilWNetEnumResource , WNetGetResourceInformation, atau fungsi WNetGetResourceParent untuk mengembalikan informasi dari struktur NETRESOURCE. Anda juga dapat membuat informasi sumber daya jaringan menggunakan anggota struktur NETRESOURCE .

Contoh penggunaan WNetGetResourceParent yang tidak pantas adalah menentukan nama domain tempat server tertentu berada. Fungsi mungkin mengembalikan nama domain yang benar untuk beberapa jaringan di mana domain muncul tepat di atas server dalam hierarki penelusuran. Fungsi ini akan mengembalikan hasil yang salah untuk jaringan lain.

Nota

Header winnetwk.h mendefinisikan WNetGetResourceParent sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	winnetwk.h
Pustaka	Mpr.lib
DLL	Mpr.dll

Lihat juga

WNetGetNetworkInformation

WNetGetProviderName

WNetGetResourceInformation

WNetGetUniversalName

Gambaran Umum Windows Networking (WNet)

Fungsi Jaringan Windows

Bagikan melalui