Функция WNetGetProviderNameA (winnetwk.h)

Статья
08/27/2023

Функция WNetGetProviderName получает имя поставщика для определенного типа сети.

Синтаксис

DWORD WNetGetProviderNameA(
  [in]      DWORD   dwNetType,
  [out]     LPSTR   lpProviderName,
  [in, out] LPDWORD lpBufferSize
);

Параметры

[in] dwNetType

Тип сети, который является уникальным для сети. Если две сети утверждают один и тот же тип, функция возвращает имя поставщика, загруженного первым. Используется только высокое слово типа сети. Если сеть сообщает о подтипе в нижнем слове, он игнорируется.

Полный список типов сетей можно найти в файле заголовка Winnetwk.h.

[out] lpProviderName

Указатель на буфер, получающий имя поставщика сети.

[in, out] lpBufferSize

Размер буфера, передаваемого в функцию, в символах. Если возвращаемое значение равно ERROR_MORE_DATA, lpBufferSize возвращает размер буфера, необходимый (в символах) для хранения имени поставщика.

Windows Me/98/95: Размер буфера составляет байты, а не символы. Кроме того, буфер должен иметь длину не менее 1 байта.

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение будет NO_ERROR.

Если функция завершается сбоем, возвращаемое значение представляет собой системный код ошибки, например одно из следующих значений.

Код возврата	Описание
ERROR_MORE_DATA	Буфер слишком мал для хранения имени поставщика сети.
ERROR_NO_NETWORK	Сеть недоступна.
ERROR_INVALID_ADDRESS	Недопустимый параметр lpProviderName или lpBufferSize .

Заголовок winnetwk.h определяет WNetGetProviderName в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winnetwk.h
Библиотека	Mpr.lib
DLL	Mpr.dll