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 el 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 informó 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 es ERROR_INVALID_ADDRESS.

Observaciones

La función WNetGetLastError de 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 de , 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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	winnetwk.h
biblioteca de	Mpr.lib
DLL de	Mpr.dll

Consulte también

redes de Windows (WNet)

funciones de red de Windows