Fonction WNetGetLastErrorA (winnetwk.h)

La fonction WNetGetLastError récupère le code d’erreur étendu le plus récent défini par une fonction WNet. Le fournisseur réseau a signalé ce code d’erreur ; il ne s’agit généralement pas de l’une des erreurs incluses dans le fichier d’en-tête du SDK WinError.h.

Syntaxe

DWORD WNetGetLastErrorA(
  [out] LPDWORD lpError,
  [out] LPSTR   lpErrorBuf,
  [in]  DWORD   nErrorBufSize,
  [out] LPSTR   lpNameBuf,
  [in]  DWORD   nNameBufSize
);

Paramètres

[out] lpError

Pointeur vers une variable qui reçoit le code d’erreur signalé par le fournisseur réseau. Le code d’erreur est spécifique au fournisseur réseau.

[out] lpErrorBuf

Pointeur vers la mémoire tampon qui reçoit la chaîne terminée par null décrivant l’erreur.

[in] nErrorBufSize

Taille de la mémoire tampon pointée vers le paramètre lpErrorBuf , en caractères. Si la mémoire tampon est trop petite pour la chaîne d’erreur, la chaîne est tronquée, mais toujours terminée par null. Une mémoire tampon d’au moins 256 caractères est recommandée.

[out] lpNameBuf

Pointeur vers la mémoire tampon qui reçoit la chaîne terminée par null identifiant le fournisseur réseau qui a déclenché l’erreur.

[in] nNameBufSize

Taille de la mémoire tampon pointée vers le paramètre lpNameBuf , en caractères. Si la mémoire tampon est trop petite pour la chaîne d’erreur, la chaîne est tronquée, mais toujours terminée par null.

Valeur retournée

Si la fonction réussit et qu’elle obtient la dernière erreur signalée par le fournisseur réseau, la valeur de retour est NO_ERROR.

Si l’appelant fournit une mémoire tampon non valide, la valeur de retour est ERROR_INVALID_ADDRESS.

Remarques

La fonction WNetGetLastError récupère les erreurs spécifiques à un fournisseur réseau. Vous pouvez appeler WNetGetLastError lorsqu’une fonction WNet retourne ERROR_EXTENDED_ERROR.

Comme la fonction GetLastError , WNetGetLastError retourne des informations d’erreur étendues, qui sont conservées par thread. Contrairement à GetLastError, la fonction WNetGetLastError peut retourner une chaîne pour signaler les erreurs qui ne sont pas décrites par un code d’erreur existant dans WinError.h.

Pour plus d’informations sur l’utilisation d’un gestionnaire d’erreurs défini par l’application qui appelle la fonction WNetGetLastError , consultez Récupération des erreurs réseau.

Notes

L’en-tête winnetwk.h définit WNetGetLastError comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

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

Voir aussi

Vue d’ensemble de Windows Networking (WNet)

Fonctions de mise en réseau Windows