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

Статья
11/20/2024

Функция 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 или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	winnetwk.h
библиотеки	Mpr.lib
DLL	Mpr.dll

См. также

WNetGetNetworkInformation

WNetGetResourceInformation

WNetGetUniversalName

Обзор сети Windows (WNet)

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

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