Export (0) Print
Expand All

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 codeDescription
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]

Header

Winnetwk.h

Library

Mpr.lib

DLL

Mpr.dll

Unicode and ANSI names

WNetGetProviderNameW (Unicode) and WNetGetProviderNameA (ANSI)

See also

Windows Networking (WNet) Overview
Windows Networking Functions
WNetGetResourceInformation
WNetGetNetworkInformation
WNetGetUniversalName

 

 

Community Additions

ADD
Show:
© 2014 Microsoft