Fungsi GetNameByTypeW (nspapi.h)

Artikel
11/20/2024

Fungsi GetNameByType mengambil nama layanan jaringan untuk jenis layanan yang ditentukan.

Note Fungsi GetNameByType adalah ekstensi khusus Microsoft untuk spesifikasi Windows Sockets 1.1. Fungsi ini usang. Untuk kenyamanan pengembang Windows Sockets 1.1, materi referensinya adalah sebagai berikut.

Catatan Fungsi yang dirinci dalam resolusi nama Protocol-Independent menyediakan fungsionalitas yang setara di Windows Sockets 2.

Sintaksis

INT GetNameByTypeW(
  [in]  LPGUID lpServiceType,
  [out] LPWSTR lpServiceName,
  [in]  DWORD  dwNameLength
);

Parameter

[in] lpServiceType

Penunjuk ke pengidentifikasi unik global (GUID) yang menentukan jenis layanan jaringan. File header Svcguid.h mencakup definisi beberapa jenis layanan GUID, dan makro untuk bekerja dengannya.

File header Svcguid.h tidak secara otomatis disertakan oleh file header Winsock2.h.

[out] lpServiceName

Penunjuk ke buffer untuk menerima string nol yang dihentikan yang secara unik mewakili nama layanan jaringan.

[in] dwNameLength

Penunjuk ke variabel yang, pada input, menentukan ukuran, dalam byte, dari buffer yang ditunjukkan oleh lpServiceName. Pada output, variabel berisi ukuran sebenarnya dari string nama layanan, dalam byte.

Mengembalikan nilai

Jika fungsi berhasil, nilai pengembalian tidak SOCKET_ERROR (–1).

Jika fungsi gagal, nilai pengembalian adalah SOCKET_ERROR (–1). Untuk mendapatkan informasi kesalahan yang diperluas, panggil GetLastError.

Komentar

Nota

Header nspapi.h mendefinisikan GetNameByType sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosedur UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	nspapi.h
Pustaka	Mswsock.lib
DLL	Mswsock.dll

Lihat juga

GetTypeByName

Winsock Functions

Referensi Winsock

Bagikan melalui