WNetGetProviderName

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

DWORD WNetGetProviderName(
  DWORD dwNetType,       // network type
  LPTSTR lpProviderName, // provider name buffer
  LPDWORD lpBufferSize   // size of buffer
);

Parameters

dwNetType

[in] Specifies the 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 in which to return the network provider name.

lpBufferSize

[in/out] Specifies the size, in characters, of the buffer passed to the function. If the return value is ERROR_MORE_DATA, lpBufferSize returns the buffer size required (in characters) to hold the provider name.

Windows 95/98: The size of the buffer is in bytes, not characters. Also, the buffer must be at least 1 byte long.

Return Values

If the function succeeds, the return value is NO_ERROR.

If the function fails, the return value can be one of the following error codes.

Requirements

  Windows NT/2000: Requires Windows NT 4.0 or later.
  Windows 95/98: Requires Windows 95 or later.
  Header: Declared in Winnetwk.h.
  Library: Use Mpr.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows NT/2000.

See Also

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