WNetSetLastErrorA, fonction (npapi.h)

Article
03/06/2024

Définit les informations d’erreur étendues. Les fournisseurs réseau doivent appeler cette fonction au lieu de SetLastError.

Si nécessaire, le routeur multi-fournisseur (MPR) appelle SetLastError pour définir l’erreur Windows retournée par un fournisseur réseau.

Syntaxe

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

Paramètres

[in] err

L'erreur qui s'est produite. Il s’agit d’un code d’erreur propre au réseau.

[in] lpError

Chaîne qui décrit l’erreur propre au réseau.

[in] lpProviders

Chaîne qui nomme le fournisseur réseau qui a déclenché l’erreur.

Valeur de retour

None

Remarques

Cette fonction est implémentée par le système d’exploitation Windows et peut être appelée par les fournisseurs réseau.

Un fournisseur doit utiliser cette fonction pour signaler les erreurs qui contiennent des informations spécifiques au fournisseur. Les informations d’erreur sont enregistrées jusqu’à ce qu’elles soient remplacées par un autre appel à WNetSetLastError dans le même thread.

La méthode recommandée pour qu’une fonction de fournisseur gère les erreurs générales consiste à utiliser l’instruction suivante.

return(providerError);

Dans cette instruction, providerError est un code d’erreur Windows, tel que l’un des codes de retour répertoriés pour l’API du fournisseur dans ce document.

Pour les erreurs spécifiques au fournisseur, un fournisseur doit effectuer les opérations suivantes.

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

Dans ce cas, providerError est le code d’erreur propre au fournisseur.

Les fournisseurs n’ont pas besoin d’appeler SetLastError avant de retourner à partir d’une fonction de fournisseur. Le MPR appelle SetLastError pour définir l’erreur Windows retournée par un fournisseur si nécessaire pour satisfaire les applications.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	npapi.h
Bibliothèque	Mpr.lib
DLL	Mpr.dll

Partager via