Função WNetSetLastErrorA (npapi.h)

Define informações de erro estendidas. Os provedores de rede devem chamar essa função em vez de SetLastError.

Quando necessário, o MPR ( Roteador de Vários Provedores ) chama SetLastError para definir o erro do Windows retornado de um provedor de rede.

Sintaxe

void WNetSetLastErrorA(
  [in] DWORD err,
  [in] LPSTR lpError,
  [in] LPSTR lpProviders
);

Parâmetros

[in] err

O erro que ocorreu. Esse é um código de erro específico da rede.

[in] lpError

Cadeia de caracteres que descreve o erro específico da rede.

[in] lpProviders

Cadeia de caracteres que nomeia o provedor de rede que gerou o erro.

Retornar valor

Nenhum

Comentários

Essa função é implementada pelo sistema operacional Windows e pode ser chamada por provedores de rede.

Um provedor deve usar essa função para relatar erros que contêm informações específicas do provedor. As informações de erro são salvas até que sejam substituídas por outra chamada para WNetSetLastError no mesmo thread.

A maneira recomendada para uma função de provedor lidar com erros gerais é usar a instrução a seguir.

return(providerError);

Nesta instrução, providerError é um código de erro do Windows, como um dos códigos de retorno listados para a API do provedor neste documento.

Para erros específicos do provedor, um provedor deve fazer o seguinte.

//  Set up lpErrorString to be the error to be reported.
WNetSetLastError(providerError,
lpErrorString,
lpProviderName) ;
return(ERROR_EXTENDED_ERROR) ;

Nesse caso, providerError é o código de erro específico do provedor.

Os provedores não precisam chamar SetLastError antes de retornar de uma função de provedor. O MPR chama SetLastError para definir o erro do Windows retornado de um provedor quando necessário para atender aos aplicativos.

Requisitos