struktur SERVICE_INFOA (nspapi.h)

Artikel
11/20/2024

Struktur SERVICE_INFO berisi informasi tentang layanan jaringan atau jenis layanan jaringan.

Sintaksis

typedef struct _SERVICE_INFOA {
  LPGUID              lpServiceType;
  LPSTR               lpServiceName;
  LPSTR               lpComment;
  LPSTR               lpLocale;
  DWORD               dwDisplayHint;
  DWORD               dwVersion;
  DWORD               dwTime;
  LPSTR               lpMachineName;
  LPSERVICE_ADDRESSES lpServiceAddress;
  BLOB                ServiceSpecificInfo;
} SERVICE_INFOA, *PSERVICE_INFOA, *LPSERVICE_INFOA;

Anggota

lpServiceType

Jenis: LPGUID

Penunjuk ke GUID yang merupakan jenis layanan jaringan.

lpServiceName

Jenis: LPTSTR

Penunjuk ke string NULLyang dihentikan yang merupakan nama layanan jaringan.

Jika Anda memanggil fungsi SetService dengan parameter dwNameSpace diatur ke NS_DEFAULT, nama layanan jaringan harus merupakan nama umum. Nama umum adalah apa yang umumnya dikenal sebagai layanan jaringan. Contoh nama umum untuk layanan jaringan adalah "My SQL Server".

Jika Anda memanggil fungsi SetService dengan parameter dwNameSpace diatur ke nama layanan tertentu, nama layanan jaringan dapat menjadi nama umum atau nama khusus. Nama khusus membedakan layanan ke lokasi unik dengan layanan direktori. Contoh nama khusus untuk layanan jaringan adalah "MS\SYS\NT\DEV\My SQL Server".

lpComment

Jenis: LPTSTR

Penunjuk ke string NULLdihentikan yang merupakan komentar atau deskripsi untuk layanan jaringan. Misalnya, "Digunakan untuk peningkatan pengembangan."

lpLocale

Jenis: LPTSTR

Penunjuk ke stringNULL yang dihentikan yang berisi informasi lokal.

dwDisplayHint

Jenis: DWORD

Petunjuk tentang cara menampilkan layanan jaringan di antarmuka pengguna penjelajahan jaringan. Ini bisa menjadi salah satu nilai berikut.

Nilai	Arti
RESOURCEDISPLAYTYPE_DOMAIN	Tampilkan layanan jaringan sebagai domain.
RESOURCEDISPLAYTYPE_FILE	Tampilkan layanan jaringan sebagai file.
RESOURCEDISPLAYTYPE_GENERIC	Metode yang digunakan untuk menampilkan objek tidak masalah.
RESOURCEDISPLAYTYPE_GROUP	Tampilkan layanan jaringan sebagai grup.
RESOURCEDISPLAYTYPE_SERVER	Tampilkan layanan jaringan sebagai server.
RESOURCEDISPLAYTYPE_SHARE	Tampilkan layanan jaringan sebagai sharepoint.
RESOURCEDISPLAYTYPE_TREE	Tampilkan layanan jaringan sebagai pohon.

dwVersion

Jenis: DWORD

Versi untuk layanan jaringan. Kata tinggi dari nilai ini menentukan nomor versi utama. Kata rendah dari nilai ini menentukan nomor versi minor.

dwTime

Jenis: DWORD

Dicadangkan untuk digunakan di masa mendatang. Harus nol.

lpMachineName

Jenis: LPTSTR

Penunjuk ke string NULLdihentikan yang merupakan nama komputer tempat layanan jaringan berjalan.

lpServiceAddress

Jenis: LPSERVICE_ADDRESSES

Penunjuk ke struktur SERVICE_ADDRESSES yang berisi array struktur SERVICE_ADDRESS. Setiap struktur SERVICE_ADDRESS berisi informasi tentang alamat layanan jaringan.

Layanan jaringan dapat memanggil fungsi getsockname untuk menentukan alamat lokal sistem.

ServiceSpecificInfo

Jenis: BLOB

Struktur BLOB yang menentukan informasi yang ditentukan layanan.

Catatan Secara umum, data yang diacu oleh struktur pBlobData anggota tidak boleh berisi pointer apa pun. Itu karena hanya layanan jaringan yang tahu format data; menyalin data tanpa pengetahuan tersebut akan menyebabkan pembatalan penunjuk. Jika data yang ditunjukkan oleh pBlobData berisi elemen berukuran variabel, offset dari pBlobData dapat digunakan untuk menunjukkan lokasi elemen tersebut. Ada satu pengecualian untuk aturan umum ini: ketika pBlobData menunjuk ke struktur SERVICE_TYPE_INFO_ABS. Ini dimungkinkan karena struktur SERVICE_TYPE_INFO_ABS, dan struktur SERVICE_TYPE_VALUE_ABS apa pun yang dikandungnya telah ditentukan sebelumnya, dan dengan demikian formatnya diketahui oleh sistem operasi.

Komentar

Nota

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