|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| No
| Win32s
| No
| Import Library
| netapi32.lib
| Header File
| winnetwk.h
| Unicode
| WinNT
| Platform Notes
| All LanMan APIs are UNICODE only
|
|
|
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
| Last news from Greatis Software |
 |
|
Nostalgia .Net |
|
.Net is powerful, but not all-powerful, so sometimes we need to use Win32 API for our .Net applications. It's simple enough with Platform Invoke if you have Win32 skill, but we do not always have time to dig the ancient documentation, declare the special types that are compatible with Win32, find the values of the Win32's constants and so on. Nostalgia .Net offers several simple-to-use classes, and components that will allow you to forget about the headache of Win32 and just use the power of Win32 in your application the same way as you use the native. Net classes. More » |
| Recommended software for developers |
 |
|
Ultimate Pack |
|
Component pack for Delphi and C++ Builder that contains runtime form designer, runtime object inspector, print suite and much more for the very special price. More » |
 |
|
Form Designer .Net |
|
Unique runtime form design solution that allows to edit any form in .Net WinForms application at runtime with full source codes for only 300 euro! More » |
 |
|
Print Suite .Net |
|
Print Suite .Net is a set of components for easy printing texts, images and grids from your WinForms applications. Full C# source codes are available More » |
 |
|
Gradient Controls .Net |
|
Gradient Controls .Net offers controls with gradient background feature. Labels, panels and so on... Full C# source codes are available More » |
 |
|
Greatis iGrid |
|
iGrid plots drawing grid right over your desktop, so you can use it everywhere, with any drawing application without any special plugins for different graphic editors. More » |
All the contacts and projectsDmitry Vasiliev (just.dmitry)
Related LinksSoftware for Visual Studio .NET developers
Software for Delphi and C++ Builder developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET More Online Helps Win32 Programmer's Reference
Win32 Multimedia Programmer's Reference
OLE Programmer's Reference
Microsoft Windows Pen API Programmer's Reference
Microsoft Windows Sockets 2 Reference
Microsoft Windows Telephony API (TAPI) Programmer's Reference
Unix Manual Pages
|
