Fungsi GetNameByTypeA (nspapi.h)

Artikel
03/09/2024

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

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

Catatan Fungsi yang dirinci dalam Resolusi Nama Independen Protokol menyediakan fungsionalitas yang setara di Windows Sockets 2.

Sintaks

INT GetNameByTypeA(
  [in]  LPGUID lpServiceType,
  [out] LPSTR  lpServiceName,
  [in]  DWORD  dwNameLength
);

Parameter

[in] lpServiceType

Penunjuk ke pengidentifikasi unik global (GUID) yang menentukan jenis layanan jaringan. File header Svcguid.h menyertakan definisi dari 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 yang dihentikan nol yang secara unik mewakili nama layanan jaringan.

[in] dwNameLength

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

Mengembalikan nilai

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

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

Keterangan

Catatan

Header nspapi.h mendefinisikan GetNameByType sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor 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

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

Lihat juga

GetTypeByName

Fungsi Winsock

Referensi Winsock

Share via