RasAdminGetErrorString fonction)

[Cette fonction est fournie uniquement pour la compatibilité descendante avec Windows NT Server 4,0. elle retourne un _ appel _ d’erreur non _ implémenté sur Windows Server 2003. Les applications doivent utiliser la fonction MprAdminGetErrorString .]

La fonction RasAdminGetErrorString récupère une chaîne de message qui correspond à un code d’erreur RAS renvoyé par l’une des fonctions d’administration de serveur RAS (RasAdmin). Ces chaînes de message sont extraites de la Rasmsg.dll installée dans le cadre du service RAS.

Syntaxe

DWORD RasAdminGetErrorString(
  _In_  UINT  ResourceId,
  _Out_ WCHAR *lpszString,
  _In_  DWORD InBufSize
);

Paramètres

ResourceId [ dans]

Spécifie un code d’erreur retourné par l’une des fonctions RasAdmin. Cette valeur doit être comprise dans la plage de codes d’erreur de RASBASE à RASBASEEND. Celles-ci sont définies dans Raserror. h.

lpszString [ à]

Pointeur vers une mémoire tampon qui reçoit le message d’erreur qui correspond au code d’erreur spécifié.

InBufSize [ dans]

Spécifie la taille, en caractères, de la mémoire tampon lpszString . Les messages d’erreur sont généralement de 80 caractères au maximum ; une taille de mémoire tampon de 512 caractères est toujours appropriée.

Valeur retournée

Si la fonction réussit, la valeur de retour est une erreur de _ réussite.

Si la fonction échoue, la valeur de retour est un code d’erreur. Cette valeur peut être une dernière valeur d’erreur définie par les fonctions LoadLibrary, GlobalAllocou LoadString . Il peut s’agir de l’un des codes d’erreur suivants :

Valeur Signification
paramètre d’erreur _ non valide _
Les paramètres ResourceId ou lpszString ne sont pas valides.
ERREUR _ de _ mémoire tampon insuffisante
La taille spécifiée par le paramètre InBufSize est trop petite.

Il n’y a pas d’informations d’erreur étendues pour cette fonction. ne pas appeler GetLastError.

Remarques

Les fonctions RasAdmin peuvent retourner des codes d’erreur qui ne sont pas dans la plage prise en charge par la fonction RasAdminGetErrorString . Par exemple, les fonctions RasAdmin peuvent retourner des codes d’erreur définis dans Lmerr. h et winerror. h. Avant d’appeler RasAdminGetErrorString, vérifiez que le code d’erreur se trouve dans la plage RASBASE à RASBASEEND, comme défini dans Raserror. h.

Configuration requise

Condition requise Valeur
Fin de la prise en charge des clients
Windows 2000 Professionnel
Fin de la prise en charge des serveurs
Windows 2000 Server
En-tête
Rassapi. h
Bibliothèque
Rassapi. lib
DLL
Rassapi.dll

Voir aussi

Vue d’ensemble du service d’accès à distance (RAS)

Fonctions d’administration du serveur RAS

LoadLibrary

GlobalAlloc

LoadString