Função WNetGetLastErrorA (winnetwk.h)

A função WNetGetLastError recupera o código de erro estendido mais recente definido por uma função WNet. O provedor de rede relatou esse código de erro; geralmente, ele não será um dos erros incluídos no arquivo de cabeçalho do SDK WinError.h.

Sintaxe

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

Parâmetros

[out] lpError

Ponteiro para uma variável que recebe o código de erro relatado pelo provedor de rede. O código de erro é específico para o provedor de rede.

[out] lpErrorBuf

Ponteiro para o buffer que recebe a cadeia de caracteres terminada em nulo que descreve o erro.

[in] nErrorBufSize

Tamanho do buffer apontado pelo parâmetro lpErrorBuf , em caracteres. Se o buffer for muito pequeno para a cadeia de caracteres de erro, a cadeia de caracteres será truncada, mas ainda terminada em nulo. Um buffer de pelo menos 256 caracteres é recomendado.

[out] lpNameBuf

Ponteiro para o buffer que recebe a cadeia de caracteres terminada em nulo que identifica o provedor de rede que gerou o erro.

[in] nNameBufSize

Tamanho do buffer apontado pelo parâmetro lpNameBuf , em caracteres. Se o buffer for muito pequeno para a cadeia de caracteres de erro, a cadeia de caracteres será truncada, mas ainda terminada em nulo.

Retornar valor

Se a função for bem-sucedida e obtiver o último erro relatado pelo provedor de rede, o valor retornado será NO_ERROR.

Se o chamador fornecer um buffer inválido, o valor retornado será ERROR_INVALID_ADDRESS.

Comentários

A função WNetGetLastError recupera erros específicos de um provedor de rede. Você pode chamar WNetGetLastError quando uma função WNet retorna ERROR_EXTENDED_ERROR.

Assim como a função GetLastError , WNetGetLastError retorna informações de erro estendidas, que são mantidas por thread. Ao contrário de GetLastError, a função WNetGetLastError pode retornar uma cadeia de caracteres para relatar erros que não são descritos por nenhum código de erro existente em WinError.h.

Para obter mais informações sobre como usar um manipulador de erros definido pelo aplicativo que chama a função WNetGetLastError , consulte Recuperando erros de rede.

Observação

O cabeçalho winnetwk.h define WNetGetLastError como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winnetwk.h
Biblioteca	Mpr.lib
DLL	Mpr.dll

Confira também

Visão geral da rede do Windows (WNet)

Funções de rede do Windows