На главную

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 | Скачать Вниз

SERVICE_INFO



The SERVICE_INFO structure contains information about a network service or a network service type.

typedef struct _SERVICE_INFO {
LPGUID lpServiceType;
LPTSTR lpServiceName;
LPTSTR lpComment;
LPTSTR lpLocale;
DWORD dwDisplayHint;
DWORD dwVersion;
DWORD dwTime;
LPTSTR lpMachineName;
LPSERVICE_ADDRESSES lpServiceAddress;
BLOB ServiceSpecificInfo;
} SERVICE_INFO;


Members

lpServiceType

Points to a GUID that is the type of the network service.

lpServiceName

Points to a zero-terminated string that is the name of the network service.
If you are calling the SetService function with the dwNameSpace parameter set to NS_DEFAULT, the network service name must be a common name A common name is what the network service is commonly known as. An example of a common name for a network service is "My SQL Server".

If you are calling the SetService function with the dwNameSpace parameter set to a specific service name, the network service name can be a common name or a distinguished name. A distinguished name distinguishes the service to a unique location with a directory service. An example of a distinguished name for a network service is "MS\\SYS\\NT\\DEV\\My SQL Server".

lpComment

Points to a zero-terminated string that is a comment or description for the network service. For example, "Used for development upgrades."

lpLocale

Points to a zero-terminated string that contains locale information.

dwDisplayHint

Specifies a hint as to how to display the network service in a network browsing user interface. This can be one of the following values:



Value Meaning
RESOURCEDISPLAYTYPE_DOMAIN Display the network service as a domain.
RESOURCEDISPLAYTYPE_FILE Display the network service as a file.
RESOURCEDISPLAYTYPE_GENERIC The method used to display the object does not matter.
RESOURCEDISPLAYTYPE_GROUP Display the network service as a group.
RESOURCEDISPLAYTYPE_SERVER Display the network service as a server.
RESOURCEDISPLAYTYPE_SHARE Display the network service as a sharepoint.
RESOURCEDISPLAYTYPE_TREE Display the network service as a tree.


dwVersion

Specifies version information for the network service. The high word of this value specifies a major version number. The low word of this value specifies a minor version number.

dwTime

This member is reserved for future use. It must be set to zero.

lpMachineName

Points to a zero-terminated string that is the name of the computer on which the network service is running.

lpServiceAddress

Points to a SERVICE_ADDRESSES structure that contains an array of SERVICE_ADDRESS structures. Each SERVICE_ADDRESS structure contains information about a network service address.

A network service can call the getsockname function to determine the local address of the system.

ServiceSpecificInfo

A BLOB structure that specifies service-defined information.

Note that, in general, the data pointed to by the BLOB structure's pBlobData member must not contain any pointers. That is because only the network service knows the format of the data; copying the data without such knowledge would lead to pointer invalidation. If the data pointed to by pBlobData contains variable-sized elements, offsets from pBlobData can be used to indicate the location of those elements. There is one exception to this general rule: when pBlobData points to a SERVICE_TYPE_INFO_ABS structure. This is possible because both the SERVICE_TYPE_INFO_ABS structure, and any SERVICE_TYPE_VALUE_ABS structures it contains are predefined, and thus their formats are known to the operating system.



See Also

BLOB, GetService, NS_SERVICE_INFO, SetService, SERVICE_ADDRESS, SERVICE_ADDRESSES, SERVICE_TYPE_INFO_ABS, SERVICE_TYPE_VALUE_ABS


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

SERVICE_INFO



Структура SERVICE_INFO содержит информации о сетевой услуге или сетевой тип услуги.

typedef struct _SERVICE_INFO { LPGUID lpServiceType;
LPTSTR lpServiceName;
lpComment LPTSTR;
LPTSTR lpLocale;
DWORD dwDisplayHint;
DWORD dwVersion;
DWORD dwTime;
LPTSTR lpMachineName;
LPSERVICE_ADDRESSES lpServiceAddress;
КАПЛЯ ServiceSpecificInfo;
} SERVICE_INFO;


Участники

lpServiceType

Точки на GUID, которые - тип сетевой услуги.

lpServiceName

Точки на расторгнутую нулевую строку, что - имя сетевой услуги.
Если Вы вызываете функцию SetService с параметром dwNameSpace установленным на NS_DEFAULT, сетевое имя услуги должно быть общим именем, которое общее имя -, которое сетевая услуга обычно известный как. Пример общего называет в честь сетевой услуги - "Мой Сервер SQL".

Если Вы вызываете функцию SetService с параметром dwNameSpace установленным в специфическое имя услуги, сетевое имя услуги может быть общим именем или выдающееся имя. Выдающееся имя различает услугу в уникальную позицию с услугой директория. Пример выдающегося называет в честь сетевой услуги - "Сервер MS\\SYS\\NT\\DEV\\My SQL".

lpComment

Точки на расторгнутую нулевую строку, что - комментарий или описание для сетевой услуги. Например, "Использованное для модернизации разработки."

lpLocale

Точки на расторгнутую нулевую строку, что содержит место действия информации.

dwDisplayHint

Определяет намек как то как, чтобы отображать сетевую услугу в сети, просматривающей интерфейс пользавателя. Это может быть одним из следующего величин:



Значение Величины
RESOURCEDISPLAYTYPE_DOMAIN Отображает сетевую услугу как область.
RESOURCEDISPLAYTYPE_FILE Отображает сетевую услугу как файл.
RESOURCEDISPLAYTYPE_GENERIC метод использованный, чтобы отображать, что объект не имеет значения.
RESOURCEDISPLAYTYPE_GROUP Отображает сетевую услугу как группу.
RESOURCEDISPLAYTYPE_SERVER Отображает сетевую услугу как сервер.
RESOURCEDISPLAYTYPE_SHARE Отображает сетевую услугу как sharepoint.
RESOURCEDISPLAYTYPE_TREE Отображает сетевую услугу как дерево.


dwVersion

Определяет информацию версии для сетевой услуги. Высокое слово этой величины определяет основной номер версии. Низкое слово этой величины определяет незначительный номер версии.

dwTime

Этот элемент зарезервирован для будущего использования. Должно быть установлено в нуль.

lpMachineName

Точки на расторгнутую нулевую строку, что - имя компьютера на котором сетевая услуга работает.

lpServiceAddress

Точки на структуру SERVICE_ADDRESSES, которые содержат массив структур SERVICE_ADDRESS. Каждая структура SERVICE_ADDRESS содержит информацию о сетевом адресе услуги.

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

ServiceSpecificInfo

Структура КАПЛИ, которая определяет определенную информацию услуги.

Отметьте, что, в общих чертах, данные указанные, чтобы КАПЛЕЙ структурного элемента pBlobData не должны содержать любые указатели. Это - поскольку только сетевая услуга знает формат данных; копирование данных без такого знания должно провести к недостоверности указателя. Если данные указанные, чтобы pBlobData содержит измеренные переменные элементы, смещения из pBlobData могут быть использованы, чтобы указывать позицию тех элементов. Есть одно исключение из этих общих правил: когда точки pBlobData на структуру SERVICE_TYPE_INFO_ABS. Возможно поскольку как структура SERVICE_TYPE_INFO_ABS, так и любые структуры SERVICE_TYPE_VALUE_ABS это содержит, встроенные, и таким образом их форматы известные в операционную систему.



Смотри Также

КАПЛЯ, GetService, NS_SERVICE_INFO, SetService, SERVICE_ADDRESS, SERVICE_ADDRESSES, SERVICE_TYPE_INFO_ABS, SERVICE_TYPE_VALUE_ABS


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