Функция WNetSetLastErrorA (npapi.h)

  • Статья

Задает расширенные сведения об ошибке. Поставщики сетей должны вызывать эту функцию вместо SetLastError.

При необходимости маршрутизатор с несколькими поставщиками (MPR) вызывает SetLastError , чтобы задать ошибку Windows, возвращенную поставщиком сети.

Синтаксис

void WNetSetLastErrorA(
  [in] DWORD err,
  [in] LPSTR lpError,
  [in] LPSTR lpProviders
);

Параметры

[in] err

Возникшая ошибка. Это код ошибки для конкретной сети.

[in] lpError

Строка, описывающая сетевую ошибку.

[in] lpProviders

Строка, которая называет поставщика сети, который вызвал ошибку.

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

None

Remarks

Эта функция реализуется операционной системой Windows и может вызываться сетевыми поставщиками.

Поставщик должен использовать эту функцию для сообщения об ошибках, содержащих сведения о поставщике. Сведения об ошибке сохраняются до тех пор, пока они не будут перезаписаны другим вызовом WNetSetLastError в том же потоке.

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

return(providerError);

В этой инструкции providerError является кодом ошибки Windows, например одним из кодов возврата, перечисленных для API поставщика в этом документе.

Для ошибок, относящихся к поставщику, поставщик должен выполнить следующие действия.

//  Set up lpErrorString to be the error to be reported.
WNetSetLastError(providerError,
lpErrorString,
lpProviderName) ;
return(ERROR_EXTENDED_ERROR) ;

В этом случае providerError — это код ошибки конкретного поставщика.

Поставщикам не нужно вызывать SetLastError перед возвратом из функции поставщика. MPR вызывает SetLastError , чтобы задать ошибку Windows, возвращаемую поставщиком, когда это необходимо для удовлетворения требований приложений.

Требования

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