Fungsi NPGetUniversalName (npapi.h)

Mengambil nama universal sumber daya jaringan. Fungsi NPGetUniversalName dapat mengambil nama universal ini dalam format UNC atau dalam format nama jarak jauh yang lebih lama.

Syntax

DWORD NPGetUniversalName(
  [in]      LPCWSTR lpLocalPath,
  [in]      DWORD   dwInfoLevel,
  [out]     LPVOID  lpBuffer,
  [in, out] LPDWORD lpBufferSize
);

Parameter-parameternya

[in] lpLocalPath

Penunjuk ke jalur lokal objek pada sumber daya jaringan. Ini adalah jalur berbasis drive.

[in] dwInfoLevel

Tingkat detail informasi yang diminati pemanggil. Ini bisa menjadi salah satu nilai berikut.

Nilai	Meaning
UNIVERSAL_NAME_INFO_LEVEL	Mengambil formulir UNC dari nama, misalnya: "file:\\server\share" Jika nilai ini diatur, data yang dikembalikan di lpBuffer disimpan sebagai struktur UNIVERSAL_NAME_INFO .
REMOTE_NAME_INFO_LEVEL	Mengambil bentuk nama jarak jauh, misalnya: "\\server\share" Jika nilai ini diatur, data yang dikembalikan dalam lpBuffer disimpan sebagai struktur REMOTE_NAME_INFO .

[out] lpBuffer

Arahkan ke buffer untuk menerima informasi yang diminta pengguna. Struktur spesifik yang dikembalikan tergantung pada tingkat informasi yang ditentukan dalam dwInfoLevel.

[in, out] lpBufferSize

Penunjuk ke ukuran, dalam byte, dari buffer lpBuffer . Jika panggilan gagal karena buffer tidak cukup besar, lokasi ini akan digunakan untuk mengembalikan ukuran buffer yang diperlukan.

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_BAD_LOCALNAME	Nilai yang diteruskan ke lpLocalPath tidak valid.
WN_NOT_CONNECTED	Nilai yang diteruskan ke lpLocalPath bukan perangkat yang dialihkan.
WN_MORE_DATA	Buffer terlalu kecil.
WN_NO_NETWORK	Jaringan tidak ada.

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