Fungsi GetTypeByNameA (nspapi.h)

Artikel
11/20/2024

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

Note Fungsi GetTypeByName adalah ekstensi khusus Microsoft untuk spesifikasi Windows Sockets 1.1. Fungsi ini usang. Untuk kenyamanan pengembang Windows Sockets 1.1, materi referensi ini disertakan. Fungsi yang dirinci dalam Resolusi Nama Protocol-Independent menyediakan fungsionalitas yang setara di Windows Sockets 2.

Sintaksis

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, "MY SNA SERVER."

[in, out] lpServiceType

Pointer ke variabel untuk menerima pengidentifikasi unik global (GUID) yang menentukan jenis layanan jaringan. File header Svcguid.h menyertakan definisi 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	Arti
ERROR_SERVICE_DOES_NOT_EXIST	Jenis layanan yang ditentukan tidak diketahui.

Komentar

Nota

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

GetNameByType

Winsock Functions

Referensi Winsock

Bagikan melalui