Fungsi GetTypeByNameA (nspapi.h)

Artikel
02/29/2024

Fungsi GetTypeByName mengambil GUID jenis layanan untuk layanan jaringan yang ditentukan berdasarkan nama.

Catatan Fungsi GetTypeByName adalah ekstensi khusus Microsoft untuk spesifikasi Windows Sockets 1.1. Fungsi ini sudah usang. Untuk kenyamanan pengembang Windows Sockets 1.1, materi referensi ini disertakan. Fungsi yang dirinci dalam Resolusi Nama Independen Protokol menyediakan fungsionalitas yang setara di Windows Sockets 2.

Sintaks

INT GetTypeByNameA(
  [in]      LPSTR  lpServiceName,
  [in, out] LPGUID lpServiceType
);

Parameter

[in] lpServiceName

Penunjuk ke string yang dihentikan nol yang secara unik mewakili nama layanan. Misalnya, "SERVER SNA SAYA."

[in, out] lpServiceType

Penunjuk ke variabel untuk menerima 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 .

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah nol.

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

Nilai	Makna
ERROR_SERVICE_DOES_NOT_EXIST	Tipe layanan yang ditentukan tidak diketahui.

Keterangan

Catatan

Header nspapi.h mendefinisikan GetTypeByName 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

GetNameByType

Fungsi Winsock

Referensi Winsock

Bagikan melalui