Fungsi NPGetResourceParent (npapi.h)

Artikel
02/29/2024

Mengambil induk sumber daya jaringan tertentu dalam hierarki penelusuran. Fungsi ini biasanya dipanggil untuk sumber daya yang dikembalikan oleh penyedia yang sama dari panggilan sebelumnya ke NPEnumResource atau NPGetResourceInformation.

Sintaks

DWORD NPGetResourceParent(
  [in]      LPNETRESOURCEW lpNetResource,
  [out]     LPVOID         lpBuffer,
  [in, out] LPDWORD        lpBufferSize
);

Parameter

[in] lpNetResource

Penunjuk ke sumber daya jaringan yang nama induknya diperlukan. NETRESOURCE dapat diperoleh dari panggilan sebelumnya ke NPEnumResource atau NPGetResourceInformation, atau dibangun oleh pemanggil.

Bidang lpRemoteName menentukan nama jarak jauh sumber daya jaringan yang induknya diperlukan.

Bidang lpProvider menentukan penyedia yang akan dipanggil. Ini harus disediakan.

Bidang dwType diisi jika program panggilan mengetahui nilainya. Jika tidak, diatur ke NULL.

Semua bidang lain di NETRESOURCE diabaikan dan tidak diinisialisasi.

[out] lpBuffer

Arahkan ke buffer untuk menerima hasilnya, yang merupakan struktur NETRESOURCE tunggal yang mewakili sumber daya induk. Bidang lpRemoteName, lpProvider, dwType, dwDisplayType, dan dwUsage dikembalikan; semua bidang lainnya diatur ke NULL.

Output lpRemoteName harus dalam format yang sama seperti yang dikembalikan dari enumerasi oleh NPEnumResource, sehingga pemanggil dapat melakukan perbandingan string peka huruf besar/kecil untuk menentukan apakah sumber daya induk sama dengan yang dikembalikan oleh NPEnumResource. Jika sumber daya input secara sintaksis memiliki induk, penyedia dapat mengembalikannya, tanpa menentukan apakah sumber daya input atau induknya benar-benar ada. Jika sumber daya tidak memiliki induk penelusuran di jaringan, maka lpRemoteName dikembalikan sebagai NULL.

Bit RESOURCEUSAGE_CONNECTABLE di bidang dwUsage yang dikembalikan tidak selalu menunjukkan bahwa sumber daya saat ini dapat disambungkan, hanya sumber daya yang dapat disambungkan ketika tersedia di jaringan.

[in, out] lpBufferSize

Penunjuk ke lokasi yang menentukan ukuran, dalam byte, dari buffer yang diacu oleh parameter lpBuffer . Jika buffer terlalu kecil untuk hasilnya, fungsi menempatkan ukuran buffer yang diperlukan di lokasi ini dan mengembalikan kesalahan WN_MORE_DATA.

Nilai kembali

Jika fungsi berhasil, fungsi harus mengembalikan WN_SUCCESS. Jika tidak, itu harus mengembalikan kode kesalahan, yang mungkin salah satu dari yang berikut ini.

Menampilkan kode	Deskripsi
WN_MORE_DATA	Buffer input terlalu kecil.
WN_BAD_NETNAME	Penyedia ini tidak memiliki sumber daya yang ditentukan oleh lpNetResource (atau sumber daya secara sintaksis tidak valid).
WN_BAD_VALUE	Baik dwUsage atau dwType tidak valid, atau ada kombinasi parameter yang salah yang ditentukan (misalnya, lpRemoteName secara sintaksis tidak valid untuk dwType).
WN_NOT_AUTHENTICATED	Pemanggil belum diautentikasi ke jaringan.
WN_ACCESS_DENIED	Pemanggil telah diautentikasi ke jaringan, tetapi tidak memiliki izin yang memadai.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	npapi.h

Bagikan melalui