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

Статья
08/25/2023

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

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

Синтаксис

void WNetSetLastErrorW(
  [in] DWORD  err,
  [in] LPWSTR lpError,
  [in] LPWSTR 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

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