Fungsi NPGetResourceParent (npapi.h)

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.

Syntax

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

Parameter-parameternya

[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

Penunjuk 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 dengan 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 sintis memiliki induk, penyedia dapat mengembalikannya, tanpa menentukan apakah sumber daya input atau induknya benar-benar ada. Jika sumber daya tidak memiliki induk telusur 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 dihubungkan ketika tersedia di jaringan.

[in, out] lpBufferSize

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

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	Penyedia ini tidak memiliki sumber daya yang ditentukan oleh lpNetResource (atau sumber daya secara sinonis tidak valid).
WN_BAD_VALUE	Baik dwUsage atau dwType tidak valid, atau ada kombinasi parameter yang salah yang ditentukan (misalnya, lpRemoteName secara sintetis 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]
Platform Target	Windows
Header	npapi.h
Library	davclnt.lib