Определяет имена доступных в настоящий момент Сетевых Ресурсов или Сетевых Принтеров; помещает их в массив переменных памяти; возвращает количество доступных сетевых ресурсов (для указанного сетевого контекста).

ANETRESOURCES(ArrayName, cNetworkName, nResourceType)

Параметры

ArrayName

Определяет имя массива переменных памяти, в который размещаются доступные Сетевые ресурсы (устройства или принтеры) указанного сетевого контекста. Если данный массив отсутствует, Visual FoxPro автоматически создает данный массив. Если массив существует, но имеет недостаточный размер для размещения всей сетевой информации, Visual FoxPro автоматически увеличит размерность данного массива. Если массив слишком велик для размещения всей сетевой информации, Visual FoxPro "укоротит" данный массив до требуемых размеров.

Если массив уже существует, а функция ANETRESOURCES( ) возвращает значение =  0 (нет доступных сетевых ресурсов для заданного контекста), размерность массива не изменяется. Если указанный массив отсутствует, а функция ANETRESOURCES( ) возвращает значение = 0, то данный массив не создается.

cNetworkName

Определяет имя Сетевого Контекста (имя компьютера в сети), для которого требуется определить доступные (от него) сетевые устройства (ресурсы или принтеры). Данный Сетевой контекст должен иметь следующий формат: "\\NetworkName". Вы не должны в обязательном порядке быть подключены к указываемому сетевому имени. Если вы указываете имя сетевого Домена, функция ANETRESOURCES( ) возвращает все имена членов данного Домена (имена зарегистрированных членов Домена).

nResourceType

Определяет тип возвращаемых сетевых ресурсов. Для определения списка имен "сетевых дисков" nResourceType = 1. Для Сетевых принтеров: nResourceType = 2. При задании значения =  0 возвращаются имена всех доступных сетевых устройств (дисков и принтеров).

Expand imageВозвращаемое значение

Числового типа (Numeric)

Expand imageКомментарии

ANETRESOURCES( ) возвращает количество доступных сетевых ресурсов или сетевых принтеров, открытых для заданного сетевого контекста, что определяет количество строк заполняемого массива. ANETRESOURCES( ) возвращает нечение = 0,  если для заданного сетевого контеста не определено ни одного сетевого устройства (устройства коллективного доступа).

NoteПримечание

До Операционной Системы Windows 2000, имена сетевых устройств были ограничены длиной в 12 символов. Если используете рассматриваемую функцию ANETRESOURCES() на рабочей станции с младшей ОС, чем Windows 2000, ANETRESOURCES() не может обработать сетевые имена для рабочих станций, которые работают под ОС равно или старше чем Windows 2000, для которых сетевые имена могут иметь более длинные имена сетевых ресурсов (больше чем 12 символов).

Для реализации данной функции используются функции Win32 API: WNetOpenEnum / WNetEnumResource; дополнительную информацию об особенностях использования смотрите при описании этих функций в специальной документации поWin32 API.

Expand imageСм. также