Fungsi WNetGetResourceParentA (winnetwk.h)

Artikel
08/27/2023

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

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

Sintaks

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 input sebagai berikut. Pemanggil biasanya mengetahui nilai yang akan disediakan untuk anggota lpProvider dan dwType setelah panggilan sebelumnya ke WNetGetResourceInformation atau WNetGetResourceParent.

Anggota	Makna
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 struktur NETRESOURCE lainnya diabaikan.

[out] lpBuffer

Arahkan ke buffer untuk menerima satu struktur NETRESOURCE yang mewakili sumber daya induk. Fungsi mengembalikan anggota lpRemoteName, lpProvider, dwType, dwDisplayType, dan dwUsage dari 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 anggota dwUsage 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 buffer lpBuffer , 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.

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

Keterangan

Fungsi WNetGetResourceParent biasanya digunakan bersama dengan fungsi WNetGetResourceInformation untuk mengurai dan menginterpretasikan jalur jaringan yang di ketik 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 Buka 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 memanggil fungsi WNetEnumResource, WNetGetResourceInformation, atau 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 ini mungkin terjadi untuk 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.

Catatan

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

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