WNetSetLastErrorA, fonction (npapi.h)
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.
void WNetSetLastErrorA(
[in] DWORD err,
[in] LPSTR lpError,
[in] LPSTR lpProviders
);
[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.
None
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.
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 |