Función WNetSetLastErrorA (npapi.h)

Establece información de error extendida. Los proveedores de red deben llamar a esta función en lugar de SetLastError.

Cuando sea necesario, el enrutador de varios proveedores (MPR) llama a SetLastError para establecer el error de Windows devuelto desde un proveedor de red.

Sintaxis

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

Parámetros

[in] err

El error que se produjo. Se trata de un código de error específico de la red.

[in] lpError

Cadena que describe el error específico de la red.

[in] lpProviders

Cadena que asigna un nombre al proveedor de red que generó el error.

Valor devuelto

None

Observaciones

El sistema operativo Windows implementa esta función y los proveedores de red pueden llamar a esta función.

Un proveedor debe usar esta función para notificar errores que contienen información específica del proveedor. La información de error se guarda hasta que se sobrescribe mediante otra llamada a WNetSetLastError en el mismo subproceso.

La forma recomendada para que una función de proveedor controle errores generales es usar la siguiente instrucción.

return(providerError);

En esta instrucción, providerError es un código de error de Windows, como uno de los códigos de retorno enumerados para la API del proveedor en este documento.

Para los errores específicos del proveedor, un proveedor debe hacer lo siguiente.

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

En este caso, providerError es el código de error específico del proveedor.

Los proveedores no necesitan llamar a SetLastError antes de devolver desde una función de proveedor. MpR llama a SetLastError para establecer el error de Windows devuelto de un proveedor cuando sea necesario para satisfacer las aplicaciones.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	npapi.h
Library	Mpr.lib
Archivo DLL	Mpr.dll