GetServiceDisplayName info  Overview  Group

The GetServiceDisplayName function obtains the display name that is associated with a particular service.

BOOL GetServiceDisplayName(

SC_HANDLE hSCManager,	// handle to a service control manager database
LPCTSTR lpServiceName,	// the service name
LPTSTR lpDisplayName,	// buffer to receive the service’s display name
LPDWORD lpcchBuffer	// size of display name buffer and display name
);

Parameters

hSCManager

Handle to a service control manager database, as returned by the OpenSCManager function.

lpServiceName

Points to a null-terminated service name string. This name is the same as the service’s registry key name.

lpDisplayName

Points to a buffer into which the function stores the service’s display name as a null-terminated string. If the function fails, this buffer will contain an empty string.

lpcchBuffer

Points to a DWORD that contains the size, in characters, of the buffer pointed to by lpDisplayName. When the function returns, this DWORD contains the size, in characters, of the service’s display name, excluding the NULL terminator.

If the buffer pointed to by lpDisplayName is too small to contain the display name, the function stores no data into it. When the function returns, the DWORD pointed to by lpcchBuffer contains the size in characters of the service’s display name, excluding the NULL terminator.

Return Values

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.

Remarks

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.

See Also

GetServiceKeyName, OpenSCManager