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 |