WNetGetProviderNameW function

The WNetGetProviderName function obtains the provider name for a specific type of network.

Syntax

DWORD WNetGetProviderNameW(
  DWORD   dwNetType,
  LPWSTR  lpProviderName,
  LPDWORD lpBufferSize
);

Parameters

dwNetType

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

Pointer to a buffer that receives the network provider name.

lpBufferSize

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
ERROR_MORE_DATA
The buffer is too small to hold the network provider name.
ERROR_NO_NETWORK
The network is unavailable.
ERROR_INVALID_ADDRESS
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]
Target Platform Windows
Header winnetwk.h
Library Mpr.lib
DLL Mpr.dll

See Also

WNetGetNetworkInformation

WNetGetResourceInformation

WNetGetUniversalName

Windows Networking (WNet) Overview

Windows Networking Functions