Função WNetGetLastErrorA (winnetwk.h)

Artigo
11/20/2024

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, 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 identificando 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.

Valor de retorno

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.

Observações

A função WNetGetLastError recupera erros específicos de um provedor de rede. Você pode chamar WNetGetLastError quando uma função WNet retornar 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 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 no 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.

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	winnetwk.h
biblioteca	Mpr.lib
de DLL	Mpr.dll

Consulte também

Visão geral WNet (Rede windows)

funções de rede do Windows

Compartilhar via