Fungsi GetServiceDisplayNameA (winsvc.h)
Mengambil nama tampilan layanan yang ditentukan.
Sintaks
BOOL GetServiceDisplayNameA(
[in] SC_HANDLE hSCManager,
[in] LPCSTR lpServiceName,
[out, optional] LPSTR lpDisplayName,
[in, out] LPDWORD lpcchBuffer
);
Parameter
[in] hSCManager
Handel ke database manajer kontrol layanan, seperti yang dikembalikan oleh fungsi OpenSCManager .
[in] lpServiceName
Nama layanan. Nama ini sama dengan nama kunci registri layanan. Yang terbaik adalah memilih nama yang kurang dari 256 karakter.
[out, optional] lpDisplayName
Penunjuk ke buffer yang menerima nama tampilan layanan. Jika fungsi gagal, buffer ini akan berisi string kosong.
Ukuran maksimum array ini adalah 4K byte. Untuk menentukan ukuran yang diperlukan, tentukan NULL untuk parameter ini dan 0 untuk parameter lpcchBuffer . Fungsi akan gagal dan GetLastError akan mengembalikan ERROR_INSUFFICIENT_BUFFER. Parameter lpcchBuffer akan menerima ukuran yang diperlukan.
Parameter ini dapat menentukan string yang dilokalkan menggunakan format berikut:
@[path]dllname,-strID
String dengan strID pengidentifikasi dimuat dari nama dll; jalur bersifat opsional. Untuk informasi selengkapnya, lihat RegLoadMUIString.
Windows Server 2003 dan Windows XP: String yang dilokalkan tidak didukung sampai Windows Vista.
[in, out] lpcchBuffer
Pointer ke variabel yang menentukan ukuran buffer yang diacu oleh lpDisplayName, dalam TCHAR.
Pada output, variabel ini menerima ukuran nama tampilan layanan, dalam karakter, tidak termasuk karakter yang mengakhiri null.
Jika buffer yang diacu oleh lpDisplayName terlalu kecil untuk memuat nama tampilan, fungsi tidak menyimpannya. Saat fungsi kembali, lpcchBuffer berisi ukuran nama tampilan layanan, tidak termasuk karakter null-terminating.
Nilai kembali
Jika fungsi berhasil, nilai yang dikembalikan bukan nol.
Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Keterangan
Ada dua nama untuk layanan: nama layanan dan nama tampilan. Nama layanan adalah nama kunci layanan dalam registri. Nama tampilan adalah nama yang mudah digunakan yang muncul di aplikasi panel kontrol Layanan, dan digunakan dengan perintah NET START . Untuk memetakan nama layanan ke nama tampilan, gunakan fungsi GetServiceDisplayName . Untuk memetakan nama tampilan ke nama layanan, gunakan fungsi GetServiceKeyName .
Catatan
Header winsvc.h mendefinisikan GetServiceDisplayName 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 XP [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | winsvc.h (sertakan Windows.h) |
| Pustaka | Advapi32.lib |
| DLL | Advapi32.dll |