WNetGetLastErrorA, fonction (winnetwk.h)

Article
11/20/2024

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 Kit de développement logiciel (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 de 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 par 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 de réseau qui a déclenché l’erreur.

[in] nNameBufSize

Taille de la mémoire tampon pointée par 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 de retour

Si la fonction réussit et obtient la dernière erreur signalée par le fournisseur de 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 de 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 des 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.

Note

L’en-tête winnetwk.h définit WNetGetLastError comme 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	winnetwk.h
bibliothèque	Mpr.lib
DLL	Mpr.dll

Voir aussi

Vue d’ensemble mise en réseau Windows (WNet)

fonctions de mise en réseau Windows

Partager via