WNetGetProviderNameA function (winnetwk.h)
The WNetGetProviderName function obtains the provider name for a specific type of network.
Syntax
DWORD WNetGetProviderNameA(
[in] DWORD dwNetType,
[out] LPSTR lpProviderName,
[in, out] LPDWORD lpBufferSize
);
Parameters
[in] 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.
[out] lpProviderName
Pointer to a buffer that receives the network provider name.
[in, out] 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 |
|---|---|
|
The buffer is too small to hold the network provider name. |
|
The network is unavailable. |
|
The lpProviderName parameter or the lpBufferSize parameter is invalid. |
Remarks
Note
The winnetwk.h header defines WNetGetProviderName as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.
Requirements
| Requirement | Value |
|---|---|
| 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 |