Fungsi NPGetUniversalName (npapi.h)

  • Artikel

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.

Sintaks

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

Parameter

[in] lpLocalPath

Arahkan 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 Makna
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 jarak jauh dari nama, misalnya: "\\server\share"

Jika nilai ini diatur, data yang dikembalikan di 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

Arahkan 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 salah satu dari yang berikut ini.

Menampilkan kode Deskripsi
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]
Target Platform Windows
Header npapi.h