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 | Скачать

WNetOpenEnum

The WNetOpenEnum function starts an enumeration of network resources or existing connections.

DWORD WNetOpenEnum(

DWORD dwScope, // scope of enumeration
DWORD dwType, // resource types to list
DWORD dwUsage, // resource usage to list
LPNETRESOURCE lpNetResource, // pointer to resource structure
LPHANDLE lphEnum // pointer to enumeration handle buffer
);

Parameters

dwScope

Specifies the scope of the enumeration. This parameter can be one of the following values:

Value Meaning
RESOURCE_CONNECTED All currently connected resources (the dwUsage parameter is ignored).
RESOURCE_GLOBALNET All resources on the network.
RESOURCE_REMEMBERED All remembered (persistent) connections (dwUsage is ignored).

dwType

Specifies the resource types to enumerate. This parameter can be a combination of the following values:

Value Meaning
RESOURCETYPE_ANY All resources (this value cannot be combined with RESOURCETYPE_DISK or RESOURCETYPE_PRINT).
RESOURCETYPE_DISK All disk resources.
RESOURCETYPE_PRINT All print resources.

If a network provider cannot distinguish between print and disk resources, it may enumerate all resources.

dwUsage

Specifies the resource usage to be enumerated. This parameter can be a combination of the following values:

Value Meaning
0 All resources
RESOURCEUSAGE_CONNECTABLE All connectable resources
RESOURCEUSAGE_CONTAINER All container resources

This parameter is ignored if the dwScope parameter is not RESOURCE_GLOBALNET.

lpNetResource

Points to a NETRESOURCE structure specifying the container to enumerate.

If this parameter is NULL, the root of the network is assumed. Windows organizes a network as a hierarchy; the root is the topmost container in the network.
If this parameter is not NULL, it must point to a NETRESOURCE structure. This structure can be filled in by the application or be returned by a call to the WNetEnumResource function. The NETRESOURCE structure must specify a container resource; that is, the RESOURCEUSAGE_CONTAINER value must be specified in the dwUsage member.

To enumerate all network resources, an application can begin the enumeration by calling WNetOpenEnum with lpNetResource set to NULL and then use the returned handle with WNetEnumResource to enumerate resources. If one of the resources in the NETRESOURCE array returned by the WNetEnumResource function is a container resource, WNetOpenEnum can be used to open the resource for further enumeration.
If the dwScope parameter is not RESOURCE_GLOBALNET, this parameter must be NULL.

lphEnum

Points to a variable filled with an enumeration handle that can be used in a subsequent call to WNetEnumResource.

Return Values

If the function succeeds, the return value is NO_ERROR.
If the function fails, the return value is an error code. To get extended error information, call GetLastError. GetLastError may return one of the following error codes:

Value Meaning
ERROR_NOT_CONTAINER The lpNetResource parameter does not point to a container.
ERROR_INVALID_PARAMETER Either the dwScope or dwType parameter is invalid, or there is a bad combination of parameters.
ERROR_NO_NETWORK No network is present.
ERROR_EXTENDED_ERROR A network-specific error occurred. To get a description of the error, use the WNetGetLastError function.

The function returns error codes for compatibility with Windows version 3.1. For compatibility with Windows NT, the function also sets the error code value returned by GetLastError.

Remarks

The WNetOpenEnum function is used to begin enumeration of the resources in a single container. The following examples show the hierarchical structure of a Microsoft LAN Manager network and a Novell Netware network:

LanMan (container, in this case the provider)
ACCOUNTING (container, in this case the domain)
\\ACCTSPAY (container, in this case the server)
PAYFILES (disk)
LASERJET (print)

Netware (container, in this case the provider)
MARKETING (container, in this case the server)
SYS (disk, first one on any Netware server)
ANOTHERVOLUME (disk)
LASERJET (print)

See Also

NETRESOURCE, WNetCloseEnum, WNetEnumResource, WNetGetLastError

Пригласи друзей и счет твоего мобильника всегда будет положительным!

Пригласи друзей и счет твоего мобильника всегда будет положительным!

WNetOpenEnum

Функция WNetOpenEnum начинает перечисление сетевых ресурсов или существующих связей.

DWORD WNetOpenEnum(

DWORD dwScope, // ОБЛАСТЬ перечисления DWORD dwType, // типов ресурса, чтобы указывать dwUsage DWORD, // использование ресурса, чтобы указывать LPNETRESOURCE lpNetResource, // указатель в структуру ресурса LPHANDLE lphEnum // указатель в буфер ручки перечисления
);

Параметры

dwScope

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

Значение Величины
RESOURCE_CONNECTED Всех к настоящему времени связанных ресурсов ( параметр dwUsage проигнорирован).
RESOURCE_GLOBALNET Всех ресурсов в сети.
RESOURCE_REMEMBERED Все поминанные связи (устойчивые) (dwUsage проигнорирован).

dwType

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

Значение Величины
RESOURCETYPE_ANY Всех ресурсов (эта величина не может быть объединена RESOURCETYPE_DISK или RESOURCETYPE_PRINT).
RESOURCETYPE_DISK Всех дисковых ресурсов.
RESOURCETYPE_PRINT Всех ресурсов распечатки.

Если сетевой поставщик не может различиться между распечаткой и дисковыми ресурсами, это может перечислить все ресурсы.

dwUsage

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

Оцените Значению 0 Всех ресурсов
RESOURCEUSAGE_CONNECTABLE Все connectable ресурсы RESOURCEUSAGE_CONTAINER Всех контейнерных ресурсов

Этот параметр проигнорирован если параметр dwScope - не RESOURCE_GLOBALNET.

lpNetResource

Точки на структуру NETRESOURCE, определяющие, что контейнер перечисляет.

Если этот параметр НЕДЕЙСТВИТЕЛЕН, корень сети принят. Windows организовывает сеть как иерархию; корень является самым верхним контейнером в сети.
Если этот параметр не НЕДЕЙСТВИТЕЛЕН, он должен указать на структуру NETRESOURCE. Эта структура может быть заполнена приложением или возвращана вызовом в функцию WNetEnumResource. Структура NETRESOURCE должна определить контейнерный ресурс; то есть, величина RESOURCEUSAGE_CONTAINER должна быть определена в элементе dwUsage.

Чтобы перечислять все сетевые ресурсы, приложение может начать перечисление вызывая WNetOpenEnum с lpNetResource установленное на НЕДЕЙСТВИТЕЛЬНЫЙ затем использовать возвращанную ручку с WNetEnumResource, чтобы перечислять ресурсы. Если один из ресурсов в массиве NETRESOURCE возвращанном функцией WNetEnumResource - контейнерный ресурс, WNetOpenEnum может быть использован, чтобы открывать ресурс для дальнейшего перечисления.
Если параметр dwScope - не RESOURCE_GLOBALNET, этот параметр должен быть НЕДЕЙСТВИТЕЛЕН.

lphEnum

Точки на переменную заполняли ручкой перечисления, что может быть использовано на последующем вызове на WNetEnumResource.

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

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

Значение Величины
ERROR_NOT_CONTAINER параметр lpNetResource не указывает на контейнер.
ERROR_INVALID_PARAMETER Или dwScope или параметр dwType - недействителен, или есть плохая комбинация параметров.
No сеть ERROR_NO_NETWORK присутствует.
ERROR_EXTENDED_ERROR сетевая-специфическая ошибка происходила. Для того, чтобы получать описание ошибки, используйте функцию WNetGetLastError.

Функция возвращает коды ошибки для совместимости с версией Windows 3.1. Для совместимости с Windows NT, функция также устанавливает кодовую величину ошибки возвращанную GetLastError.

Замечания

Функция WNetOpenEnum использована, чтобы начинать перечисление ресурсов в единственном контейнере. Следующие примеры показывают иерархическую структуру сети Менеджера Микрософт LAN и сеть Сетевого обеспечения Novell:

LanMan УЧЕТА (контейнер, в этом случае поставщик) (контейнер, в этом случае область) \\ACCTSPAY (контейнер, в этом случае сервер) PAYFILES (диск) ЛАЗЕРНАЯ (распечатка)

Сетевое обеспечение МАРКЕТИНГА (контейнер, в этом случае поставщик) (контейнер, в этом случае сервер) SYS (диск, сначала один в любом сервере Сетевого обеспечения) ANOTHERVOLUME (диск) ЛАЗЕРНАЯ (распечатка)

Смотри Также

NETRESOURCE, WNetCloseEnum, WNetEnumResource, WNetGetLastError

Используются технологии uCoz