Поделиться через

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

  • Статья

Функция 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

См. также раздел

WNetGetNetworkInformation

WNetGetResourceInformation

WNetGetUniversalName

Общие сведения о сети Windows (WNet)

Сетевые функции Windows