Platform SDK: DLLs, Processes, and Threads |
The GetServiceDisplayName function retrieves the display name of the specified service.
BOOL GetServiceDisplayName( SC_HANDLE hSCManager, // handle to SCM database LPCTSTR lpServiceName, // service name LPTSTR lpDisplayName, // display name LPDWORD lpcchBuffer // size of display name buffer );
If the buffer pointed to by lpDisplayName is too small to contain the display name, the function does not store it. When the function returns, lpcchBuffer contains the size of the service's display name, excluding the NULL terminator.
If the functions succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, call GetLastError.
There are two names for a service: the service name and the display name. The service name is the name of the service's key in the registry. The display name is a user-friendly name that appears in the Services control panel application, and is used with the NET START command. To map the service name to the display name, use the GetServiceDisplayName function. To map the display name to the service name, use the GetServiceKeyName function.
Windows NT/2000: Requires Windows NT 3.5 or later.
Header: Declared in Winsvc.h; include Windows.h.
Library: Use Advapi32.lib.
Unicode: Implemented as Unicode and ANSI versions on Windows NT/2000.
Services Overview, Service Functions, GetServiceKeyName, OpenSCManager