WNetSetLastErrorW, fonction (npapi.h)

Article
03/04/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 à plusieurs fournisseurs (MPR) appelle SetLastError pour définir l’erreur Windows retournée par un fournisseur réseau.

Syntaxe

void WNetSetLastErrorW(
  [in] DWORD  err,
  [in] LPWSTR lpError,
  [in] LPWSTR 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 spécifique 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 de 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 sont 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 spécifique 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