Función WNetGetLastErrorA (winnetwk.h)

La función WNetGetLastError recupera el código de error extendido más reciente establecido por una función WNet. El proveedor de red notificó este código de error; por lo general, no será uno de los errores incluidos en el archivo de encabezado del SDK WinError.h.

Sintaxis

DWORD WNetGetLastErrorA(
  [out] LPDWORD lpError,
  [out] LPSTR   lpErrorBuf,
  [in]  DWORD   nErrorBufSize,
  [out] LPSTR   lpNameBuf,
  [in]  DWORD   nNameBufSize
);

Parámetros

[out] lpError

Puntero a una variable que recibe el código de error notificado por el proveedor de red. El código de error es específico del proveedor de red.

[out] lpErrorBuf

Puntero al búfer que recibe la cadena terminada en null que describe el error.

[in] nErrorBufSize

Tamaño del búfer al que apunta el parámetro lpErrorBuf , en caracteres. Si el búfer es demasiado pequeño para la cadena de error, la cadena se trunca pero sigue terminada en null. Se recomienda un búfer de al menos 256 caracteres.

[out] lpNameBuf

Puntero al búfer que recibe la cadena terminada en null que identifica al proveedor de red que generó el error.

[in] nNameBufSize

Tamaño del búfer al que apunta el parámetro lpNameBuf , en caracteres. Si el búfer es demasiado pequeño para la cadena de error, la cadena se trunca pero sigue terminada en null.

Valor devuelto

Si la función se ejecuta correctamente y obtiene el último error que notificó el proveedor de red, el valor devuelto es NO_ERROR.

Si el autor de la llamada proporciona un búfer no válido, el valor devuelto se ERROR_INVALID_ADDRESS.

Comentarios

La función WNetGetLastError recupera errores específicos de un proveedor de red. Puede llamar a WNetGetLastError cuando una función WNet devuelve ERROR_EXTENDED_ERROR.

Al igual que la función GetLastError , WNetGetLastError devuelve información de error extendida, que se mantiene por subproceso. A diferencia de GetLastError, la función WNetGetLastError puede devolver una cadena para notificar errores que no se describen mediante ningún código de error existente en WinError.h.

Para obtener más información sobre el uso de un controlador de errores definido por la aplicación que llama a la función WNetGetLastError , consulte Recuperación de errores de red.

Nota

El encabezado winnetwk.h define WNetGetLastError como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

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

Consulte también

Información general sobre redes de Windows (WNet)

Funciones de redes de Windows