| |||
| БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО! | |||
| |||
NetServerEnumThe NetServerEnum function lists all servers of the specified type that are visible in the specified domain. For example, an application can call NetServerEnum to list all domain controllers only or all SQL servers only. You can combine bit masks to list several types. For example, a value of 0x00000003 combines the bit masks for SV_TYPE_WORKSTATION (0x00000001) and SV_TYPE_SERVER (0x00000002). Note If you require more information on the type, name, and comment for a specific server, use the WNetEnumResource function. Security Requirements No special group membership is required to successfully execute NetServerEnum. NET_API_STATUS NetServerEnum( LPTSTR servername, DWORD level, LPBYTE *bufptr, DWORD prefmaxlen, LPDWORD entriesread, LPDWORD totalentries, DWORD servertype, LPTSTR domain, LPDWORD resume_handle ); Parameters servername Pointer to a Unicode string containing the name of the remote server on which the function is to execute. A NULL pointer or string specifies the local computer. level Specifies one of the following values to return the level of information provided. Value Meaning 100 The bufptr parameter points to an array of SERVER_INFO_100 structures. 101 The bufptr parameter points to an array of SERVER_INFO_101 structures. bufptr Pointer to the buffer in which the data set with the level parameter is stored. prefmaxlen Preferred maximum length, in 8-bit bytes of returned data. entriesread On return, the actual enumerated element count is located in the doubleword pointed to by entriesread. totalentries Returns the total number of visible servers and workstations on the network. servertype A DWORD mask that filters server entries to return from the enumeration. The defined mask bits specify: Symbolic constant Value Meaning SV_TYPE_WORKSTATION 0x00000001 All LAN Manager workstations SV_TYPE_SERVER 0x00000002 All LAN Manager servers SV_TYPE_SQLSERVER 0x00000004 Any server running with Microsoft SQL Server SV_TYPE_DOMAIN_CTRL 0x00000008 Primary domain controller SV_TYPE_DOMAIN_BAKCTRL 0x00000010 Backup domain controller SV_TYPE_TIMESOURCE 0x00000020 Server running the Timesource service SV_TYPE_AFP 0x00000040 Apple File Protocol servers SV_TYPE_NOVELL 0x00000080 Novell servers SV_TYPE_DOMAIN_MEMBER 0x00000100 LAN Manager 2.x Domain Member SV_TYPE_LOCAL_LIST_ONLY 0x40000000 Servers maintained by the browser. See the following Remarks section. SV_TYPE_PRINT 0x00000200 Server sharing print queue SV_TYPE_DIALIN 0x00000400 Server running dial-in service SV_TYPE_XENIX_SERVER 0x00000800 Xenix server SV_TYPE_MFPN 0x00004000 Microsoft File and Print for Netware SV_TYPE_NT 0x00001000 Windows NT (either Workstation or Server) SV_TYPE_WFW 0x00002000 Server running Windows for Workgroups SV_TYPE_SERVER_NT 0x00008000 Windows NT Non-DC server SV_TYPE_POTENTIAL_BROWSER 0x00010000 Server that can run the Browser service SV_TYPE_BACKUP_BROWSER 0x00020000 Server running a Browser service as backup SV_TYPE_MASTER_BROWSER 0x00040000 Server running the master Browser service SV_TYPE_DOMAIN_MASTER 0x00080000 Server running the domain master Browser SV_TYPE_DOMAIN_ENUM 0x80000000 Primary Domain SV_TYPE_WINDOWS 0x00400000 Windows 95 or later SV_TYPE_ALL 0xFFFFFFFF All servers domain A pointer to a Unicode string containing the name of the domain for which a list of servers is to returned. If NULL is specified, the primary domain is implied. resume_handle Reserved. Must be set to zero. Use the Wnet functions. Return Values If the function returns account information, the return value is NERR_Success. If the function fails, the return value is one of the following error codes: Value Meaning ERROR_ACCESS_DENIED The user does not have access to the requested information. NERR_InvalidComputer The computer name is invalid. ERROR_NO_BROWSER_SERVERS_FOUND No browser servers found. ERROR_MORE_DATA More entries are available with subsequent calls. Remarks The SV_TYPE_LOCAL_LIST_ONLY flag returns the list of servers maintained by the browser internally. This has meaning only on the master browser (or on a computer that has been the master browser in the past). The master browser is the machine that currently has rights to determine which machines can be servers or workstations on the net. See Also NetServerDiskEnum, NetQueryDisplayInformation, SERVER_INFO_100, SERVER_INFO_101 | |||
| Пригласи друзей и счет твоего мобильника всегда будет положительным! | |||
| |||
| Пригласи друзей и счет твоего мобильника всегда будет положительным! | |||
NetServerEnumФункция NetServerEnum включает все серверы определенного типа, который видимый в определенной области. Например, приложение может назвать NetServerEnum, чтобы указывать всех доменных диспетчеров только или все серверы SQL только. Вы можете объединить битовые маски, чтобы указывать несколько типов. Например, величина 0x00000003 объединяет битовые маски для SV_TYPE_WORKSTATION (0x00000001) и SV_TYPE_SERVER (0x00000002). Примечание Если Вы требуете больше информации о типе, называете, и комментируетесь для специфического сервера, используете функцию WNetEnumResource. Требования Безопасности Требуется, чтобы Никакое специальное групповое членство успешно не выполнило NetServerEnum. NET_API_STATUS NetServerEnum( LPTSTR servername, УРОВЕНЬ DWORD, LPBYTE *bufptr, DWORD prefmaxlen, LPDWORD entriesread, LPDWORD totalentries, DWORD servertype, область LPTSTR, resume_handle LPDWORD ); Параметры servername Указатель в строку Уникода, содержащую имя дистанционного сервера на котором функция должна выполняться. НЕДЕЙСТВИТЕЛЬНЫЙ указатель или строка определяет локальный компьютер. уровень Определяет одно из следующего величин, чтобы возвращать уровень предусмотренной информации. Значение Величины 100 Параметр bufptr указывает на массив структур SERVER_INFO_100. 101 Параметр bufptr указывает на массив структур SERVER_INFO_101. bufptr Указатель в буфер в котором данные установленные параметром уровня загружены. prefmaxlen Предпочтительная максимальная длина, в 8- битовых байтах возвращанных данных. entriesread В возврате, фактический перечисленный элементный счет расположен в двойном слове указанном, чтобы entriesread. totalentries Возвращает общее число видимых серверов и рабочих станций в сеть. servertype Маска DWORD, которая фильтрует данные сервера, чтобы возвращаться из перечисления. Определенные биты маски определяют: Символическая постоянная Величина, означающая SV_TYPE_WORKSTATION 0x00000001 Все рабочие станции Менеджера LAN SV_TYPE_SERVER 0x00000002 Все серверы Менеджера LAN SV_TYPE_SQLSERVER 0x00000004 Любой прогон сервера с 0x00000008 Первичным доменным диспетчером Микрософт SQL Server SV_TYPE_DOMAIN_CTRL 0x00000010 Резервного доменного диспетчера SV_TYPE_DOMAIN_BAKCTRL 0x00000020 Сервера SV_TYPE_TIMESOURCE, выполняющим 0x00000040 Яблочный Файловый Протокол серверов услуги Timesource SV_TYPE_AFP SV_TYPE_NOVELL серверов 0x00000080 Novell SV_TYPE_DOMAIN_MEMBER Менеджера 0x00000100 LAN 0x40000000 Серверов 2.x Domain Member SV_TYPE_LOCAL_LIST_ONLY поддерживалась окном просмотра. Смотри секцию Замечаний следующего. 0x00000200 Сервер SV_TYPE_PRINT, использовавший очередь распечатки SV_TYPE_DIALIN 0x00000400 Сервера, выполняющую абонента-в услуге SV_TYPE_XENIX_SERVER сервера 0x00000800 Xenix SV_TYPE_MFPN Файла 0x00004000 Микрософт и Распечатка для Netware SV_TYPE_NT 0x00001000 Windows NT (или Рабочая станция или Сервер) 0x00002000 Сервер SV_TYPE_WFW, выполняющий Windows для Workgroups SV_TYPE_SERVER_NT сервера 0x00008000 Windows NT Non-DC 0x00010000 Сервера SV_TYPE_POTENTIAL_BROWSER, который может запустить 0x00020000 Сервер Окна просмотра услуги SV_TYPE_BACKUP_BROWSER, выполняющий Окно просмотра услуги как резервный 0x00040000 Сервер SV_TYPE_MASTER_BROWSER, выполняющий основной 0x00080000 Сервер Окна просмотра услуги SV_TYPE_DOMAIN_MASTER, выполняющий доменного мастера Browser SV_TYPE_DOMAIN_ENUM 0x80000000 Primary Domain SV_TYPE_WINDOWS 0x00400000 Windows 95 или позже SV_TYPE_ALL 0xFFFFFFFF Всех серверов область Указатель в строку Уникода, содержащую имя области для которой список серверов - на возвращанное. Если НЕДЕЙСТВИТЕЛЬНЫЙ определен, первичная область подразумевалась. resume_handle Зарезервированное. Должно быть установлено в нуль. Используйте функции Wnet. Обратные Величины Если функция возвращает учетную информацию, обратная величина - NERR_Success. Если функция терпит неудачу, обратная величина - один из следующих кодов ошибки: Значение Величины ERROR_ACCESS_DENIED пользователь нет имеет доступ к запрошенной информации. NERR_InvalidComputer компьютерное имя недействительно. No окно просмотра серверов ERROR_NO_BROWSER_SERVERS_FOUND обнаруживалось. ERROR_MORE_DATA Более данные доступны с последующими вызовами. Замечания Флаг SV_TYPE_LOCAL_LIST_ONLY возвращает список серверов поддержанных окном просмотра непосредственно. Это имеет означая только в основном окне просмотра (или в компьютере, который был основным окном просмотра в прошлом). Основное окно просмотра является машиной, которая к настоящему времени имеет права определять, что какие машины могут быть серверы или рабочие станции в сети. Смотри Также NetServerDiskEnum, NetQueryDisplayInformation, SERVER_INFO_100, SERVER_INFO_101 | |||
| |||
 |
