WNetGetProviderName function
The WNetGetProviderName function obtains the provider name for a specific type of network.
Syntax
DWORD WNetGetProviderName( _In_ DWORD dwNetType, _Out_ LPTSTR lpProviderName, _Inout_ LPDWORD lpBufferSize );
Parameters
- dwNetType [in]
-
Network type that is unique to the network. If two networks claim the same type, the function returns the name of the provider loaded first. Only the high word of the network type is used. If a network reports a subtype in the low word, it is ignored.
You can find a complete list of network types in the header file Winnetwk.h.
- lpProviderName [out]
-
Pointer to a buffer that receives the network provider name.
- lpBufferSize [in, out]
-
Size of the buffer passed to the function, in characters. If the return value is ERROR_MORE_DATA, lpBufferSize returns the buffer size required (in characters) to hold the provider name.
Windows Me/98/95: The size of the buffer is in bytes, not characters. Also, the buffer must be at least 1 byte long.
Return value
If the function succeeds, the return value is NO_ERROR.
If the function fails, the return value is a system error code, such as one of the following values.
| Return code | Description |
|---|---|
|
The buffer is too small to hold the network provider name. |
|
The network is unavailable. |
|
The lpProviderName parameter or the lpBufferSize parameter is invalid. |
Requirements
|
Minimum supported client | Windows 2000 Professional [desktop apps only] |
|---|---|
|
Minimum supported server | Windows 2000 Server [desktop apps only] |
|
Header |
|
|
Library |
|
|
DLL |
|
|
Unicode and ANSI names | WNetGetProviderNameW (Unicode) and WNetGetProviderNameA (ANSI) |
See also
- Windows Networking (WNet) Overview
- Windows Networking Functions
- WNetGetResourceInformation
- WNetGetNetworkInformation
- WNetGetUniversalName