На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

GetServiceDisplayName



The GetServiceDisplayName function obtains the display name that is associated with a particular service name. The service name is the same as the service's registry key name.

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 machine's service control manager database. This parameter is an RPC server handle 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, which is the actual name of the service's key in the registry's Services section, and a more user-friendly display name that appears in the Services Control Panel application and is used with the NET START command. The GetServiceDisplayName and GetServiceKeyName functions let an application map one of these names to the other. An application passes a service's registry key name to GetServiceDisplayName, and obtains the service's user-friendly display name. An application passes a service's display name to GetServiceKeyName, and obtains the service's registry key name.

See Also

GetServiceKeyName, OpenSCManager




Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

GetServiceDisplayName



Функция GetServiceDisplayName получает дисплейное имя, которое связано конкретным именем услуги. Имя услуги такое же как и регистрация услуги ключевого имени.

BOOL GetServiceDisplayName(

SC_HANDLE hSCManager, // ручка базе данных управляющего менеджера услуги LPCTSTR lpServiceName, // имя услуги LPTSTR lpDisplayName, // буфера, чтобы получать дисплейное имя размера услуги LPDWORD lpcchBuffer // дисплейного буфера имени и отображать имя
);


Параметры

hSCManager

Прооперируйте управляющего менеджера машинной базы данных услуги. Этот параметр является ручкой сервера RPC как возвращано функцией OpenSCManager.

lpServiceName

Точки на недействительный строку имени расторгнутой услуги. Это зовут такой же как и регистрация услуги ключевого имени.

lpDisplayName

Точки на буфер в которые функция загружает дисплейное имя услуги как недействительный расторгнутую строку. Если функция терпит неудачу, этот буфер будет содержать пустую строку.

lpcchBuffer

Точки на DWORD, которые содержат размер, в символах, буфера указанного, чтобы lpDisplayName. Когда функция возвращает, это DWORD содержит размер, в символах, дисплейного имени услуги, исключающего НЕДЕЙСТВИТЕЛЬНЫЙ терминатор.
Если буфер указанный, чтобы lpDisplayName слишком небольшой, чтобы содержать дисплейное имя, функция не загружает никакие данные в это. Когда функция возвращает, DWORD указанное, чтобы lpcchBuffer содержит размер в типы дисплейный имя услуга, исключающий НЕДЕЙСТВИТЕЛЬНЫЙ терминатор.



Обратные Величины

Если функции добивается успеха, обратная величина ненулевая.
Если функция терпит неудачу, обратная величина нулевая. Для того, чтобы расширять информацию ошибки, назовите GetLastError.

Замечания

Есть два называет в честь услуги: имя услуги, которое - фактическое имя клавиши услуги в секции Услуг регистрации, и более дружественном дисплейном имени, которые появляются на Панели Управления приложения Услуг и использованы ЧИСТОЙ командой НАЧАЛА. GetServiceDisplayName И функции GetServiceKeyName были позволены прикладная карта одно из этих имен другому. Приложение передает регистрацию услуги ключевого имени на GetServiceDisplayName и получает дружественное дисплейное имя услуги. Приложение передает дисплейное имя услуги на GetServiceKeyName и получает регистрацию услуги ключевого имени.

Смотри Также

GetServiceKeyName, OpenSCManager




Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz