Fungsi NPGetResourceInformation (npapi.h)

Memisahkan bagian dari sumber daya jaringan yang diakses melalui API WNet dari bagian yang diakses melalui API khusus untuk jenis sumber daya.

Syntax

DWORD NPGetResourceInformation(
  [in]      LPNETRESOURCEW lpNetResource,
  [out]     LPVOID         lpBuffer,
  [in, out] LPDWORD        lpBufferSize,
  [out]     LPWSTR         *lplpSystem
);

Parameter-parameternya

[in] lpNetResource

Menentukan sumber daya jaringan yang informasinya diperlukan. Bidang lpRemoteName menentukan nama sumber daya jarak jauh. Program panggilan harus mengisi nilai untuk bidang lpProvider dan dwType jika mengetahui nilai-nilai ini; jika tidak, bidang ini harus diatur ke NULL. Semua bidang lain di NETRESOURCE diabaikan dan tidak diinisialisasi.

Jika string lpRemoteName berisi bagian yang diakses melalui API WNet dan bagian yang diakses melalui API sistem lain khusus untuk jenis sumber daya, fungsi harus mengembalikan informasi hanya tentang bagian jaringan sumber daya (kecuali untuk lplpSystem, seperti yang dijelaskan nanti dalam topik ini).

Misalnya, jika sumber daya adalah "\server\share\dir1\dir2", di mana "\server\share" diakses melalui API WNet dan "\dir1\dir2" diakses melalui API sistem file, penyedia harus memverifikasi bahwa itu adalah penyedia yang tepat untuk "\server\share", tetapi tidak perlu memeriksa apakah "\dir1\dir2" sebenarnya ada.

[out] lpBuffer

Arahkan ke buffer untuk menerima hasilnya. Bidang pertama dalam hasil adalah struktur NETRESOURCE tunggal, dan string terkait, yang mewakili bagian sumber daya input yang diakses melalui API WNet, bukan API sistem khusus untuk jenis sumber daya. Misalnya, jika nama sumber daya jarak jauh input adalah "\server\share\dir1\dir2", maka NETRESOURCE output berisi informasi tentang sumber daya "\server\share". Bidang lpRemoteName, lpProvider, dwType, dwDisplayType, dan dwUsage dikembalikan berisi nilai, semua bidang lain yang diatur ke NULL.

Bidang lpRemoteName harus dikembalikan dalam format yang sama dengan yang dikembalikan dari enumerasi oleh fungsi NPEnumResource , sehingga pemanggil dapat melakukan perbandingan string peka huruf besar/kecil. Ini diperlukan untuk menentukan apakah sumber daya jaringan output sama dengan yang dikembalikan oleh NPEnumResource.

Penyedia tidak boleh melakukan pemeriksaan sindikat murni untuk menentukan apakah ia memiliki sumber daya. Ini dapat menghasilkan hasil yang salah ketika dua jaringan berjalan pada klien dan penyedia yang melakukan pemeriksaan sindikat dipanggil terlebih dahulu.

[in, out] lpBufferSize

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

[out] lplpSystem

Pada pengembalian yang berhasil, pointer ke string null-terminated di buffer output yang menentukan bagian sumber daya yang diakses melalui API sistem khusus untuk jenis sumber daya, bukan melalui WNet API. Jika tidak ada bagian seperti itu, lplpSystem diatur ke NULL. Misalnya, jika nama sumber daya jarak jauh input adalah "\server\share\dir", lpRemoteName dikembalikan menunjuk ke "\server\share" dan lplpSystem menunjuk ke "\dir", kedua string yang disimpan dalam buffer yang ditujukkan oleh lpBuffer.

Mengembalikan nilai

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

Mengembalikan kode	Description
WN_MORE_DATA	Buffer input terlalu kecil.
WN_BAD_NETNAME	Sumber daya tidak dikenali oleh penyedia ini.
WN_BAD_VALUE	dwUsage atau dwType tidak valid.
WN_BAD_DEV_TYPE	Penelepon meneruskan dwType nonzero yang tidak cocok dengan jenis sumber daya jaringan yang sebenarnya.
WN_NOT_AUTHENTICATED	Pemanggil belum diautentikasi ke jaringan.
WN_ACCESS_DENIED	Pemanggil telah diautentikasi ke jaringan tetapi tidak memiliki izin yang memadai.

Komentar

Pohon enumerasi dapat dinavigasi ke bawah dari sumber daya jaringan bernama dengan menggunakan NPOpenEnum dan fungsi terkait. Untuk menavigasi dari sumber daya bernama, fungsi NPGetResourceInformation dapat dipanggil untuk mendapatkan informasi tentang sumber daya, diikuti oleh fungsi NPGetResourceParent untuk mendapatkan nama dan jenis sumber daya induk.

NPGetResourceInformation menentukan apakah penyedia yang ditentukan adalah penyedia yang tepat untuk menanggapi permintaan sumber daya jaringan tertentu. Kemudian mengembalikan informasi tentang jenis sumber daya.

Persyaratan

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