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

MultinetGetConnectionPerformance

The MultinetGetConnectionPerformance function returns information about the expected performance of a connection used to access a network resource. This function can be used only to request information for a local device that is redirected to a network resource, or for a network resource to which there is currently a connection.

MultinetGetConnectionPerformance(

LPNETRESOURCE lpNetResource,
LPNETCONNECTINFOSTRUCT lpNetConnectInfoStruct,
);

Parameters

lpNetResource

Specifies one of the following network resources:

Value Meaning
lpLocalName Pointer to a buffer that specifies a local device, such as "F:" or "LPT1", that is redirected to a network resource to be queried. If this parameter is NULL or an empty string, the network resource is specified in lpRemoteName. If this flag specifies a local device, lpRemoteName is ignored.
LpRemoteName Specifies a network resource to query. The resource must currently have an established connection. For example, if the resource is a file on a file server, then having the file open will ensure the connection.
LpProvider Usually set to NULL, but may be optionally specified if the network on which the resource resides is known. If lpProvider is not NULL, Windows will try only the named network.

lpNetConnectInfoStruct

Pointer to the NETCONNECTINFOSTRUCT structure.

Return Values

If the function succeeds, the return value is NO_ERROR.
If the function fails, the return value is one or more of the following error values.

Value Meaning
ERROR_NOT_SUPPORTED The network resource does not supply this information.
ERROR_NOT_CONNECTED lpLocalName is not a redirected device, or lpRemoteName is not the name of a resource that is currently connected.
ERROR_NO_NET_OR_BAD_PATH The operation could not be handled either because a network component is not started or the specified resource name is not recognized.
ERROR_BAD_DEVICE lpLocalName is invalid.
ERROR_BAD_NET_NAME lpRemoteName was not recognized by any network.
ERROR_INVALID_PARAMETER Either lpNetConnectInfoStruct does not point to a NETCONNECTINFOSTRUCT structure in which cbStructure is filled with the structure size, or both lpLocalName and lpRemoteName are not specified.
ERROR_NO_NETWORK Network components are not running.
ERROR_EXTENDED_ERROR A network-specific error occurred. To obtain a description of the error, call WNetGetLastError.

Remarks

The information returned by the MultinetGetConnectionPerformance function is an estimate only. Network traffic and routing can affect the accuracy of the results returned.
A typical way to use this function would be to open a file on a network server (which would ensure that there is a connection to the file), call this function, and use the results to make decisions about how to manage file I/O. For example, you can decide whether to read the entire file into a temporary file on the client or directly access the file on the server.

See Also

NETRESOURCE, WNetGetLastError

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

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

MultinetGetConnectionPerformance

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

MultinetGetConnectionPerformance(

LPNETRESOURCE lpNetResource, LPNETCONNECTINFOSTRUCT lpNetConnectInfoStruct,
);

Параметры

lpNetResource

Определяет один из следующих сетевых ресурсов:

Значение Величины
УКАЗАТЕЛЬ lpLocalName в буфер, который определяет локальное устройство, как например, "F:" или "LPT1", что переназначен в сетевой ресурс, который нужно спрашивать. Если этот параметр НЕДЕЙСТВИТЕЛЕН или пустая строка, сетевой ресурс определен в lpRemoteName. Если этот флаг определяет локальное устройство, lpRemoteName проигнорирован.
LpRemoteName ОПРЕДЕЛЯЕТ сетевой ресурс на запрос. Ресурс должен к настоящему времени иметь установленную связь. Например, если ресурс является файлом в файловом сервере, тогда иметь файловый открытый гарантирует связь.
LpProvider ОБЫЧНО был установлен на НЕДЕЙСТВИТЕЛЬНЫЙ, но может дополнительно определен если сеть на которой ресурс находится, известный. Если lpProvider не НЕДЕЙСТВИТЕЛЕН, Windows попытается только поименованная сеть.

lpNetConnectInfoStruct

Указатель в структуру NETCONNECTINFOSTRUCT.

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

Если функция добивается успеха, обратная величина - NO_ERROR.
Если функция терпит неудачу, обратная величина - одна или более из следующих величин ошибки.

Значение Величины
ERROR_NOT_SUPPORTED сетевой ресурс не поставляет эту информацию.
ERROR_NOT_CONNECTED lpLocalName - не переназначенное устройство, или lpRemoteName - не имя ресурса, который к настоящему времени связан.
ERROR_NO_NET_OR_BAD_PATH операция не могла оперирована или поскольку сетевой компонент не запущен или определенное имя ресурса не признано.
ERROR_BAD_DEVICE lpLocalName недействителен.
ERROR_BAD_NET_NAME lpRemoteName не был признан любой сетью.
ERROR_INVALID_PARAMETER Также lpNetConnectInfoStruct не указывает на структуру NETCONNECTINFOSTRUCT в которой cbStructure заполнен структурным размером, или как lpLocalName так и lpRemoteName не определены.
компоненты Сети ERROR_NO_NETWORK не работают.
ERROR_EXTENDED_ERROR сетевая-специфическая ошибка происходила. Для того, чтобы получать описание ошибки, назовите WNetGetLastError.

Замечания

Информация возвращанная функцией MultinetGetConnectionPerformance - оценка только. Сетевое движение и маршрутизация могут повлиять на точность возвращанных результатов.
Типичный путь использовать эту функцию должно бы открывать файл в сетевом сервере (который должен гарантировать, что есть связь в файл), называть эту функцию и использовать результаты, чтобы принимать решение собираться управлять файлом В/В. Например, Вы можете решить читать целый файл во временный файл на клиенте или непосредственно иметь доступ к файлу в сервере.

Смотри Также

NETRESOURCE, WNetGetLastError

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