Fungsi GetNameByTypeA (nspapi.h)
Fungsi GetNameByType mengambil nama layanan jaringan untuk jenis layanan yang ditentukan.
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 |