RasAdminPortEnum 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 MprAdminPortEnum .]

La fonction RasAdminPortEnum énumère tous les ports sur le serveur RAS spécifié. Pour chaque port sur le serveur, la fonction retourne la structure du _ port RAS _ 0 qui contient des informations sur le port.

Syntaxe

DWORD RasAdminPortEnum(
  _In_  const WCHAR       *lpszServer,
  _Out_       PRAS_PORT_0 *ppRasPort0,
  _Out_       WORD        *pcEntriesRead
);

Paramètres

lpszServer [ dans]

Pointeur vers une chaîne Unicode terminée par le caractère null qui spécifie le nom du serveur RAS. Spécifiez le nom avec les \ \ caractères «» de début, sous la forme : \ \ NomServeur.

ppRasPort0 [ à]

Pointeur vers une variable qui reçoit un pointeur vers une mémoire tampon qui contient un tableau de structures du _ port RAS _ 0 . Lorsque l’application a terminé la mémoire, libérez-la en appelant la fonction RasAdminFreeBuffer .

pcEntriesRead [ à]

Pointeur vers une variable de 16 bits qui reçoit le nombre total de structures RAS _ port _ 0 retournées dans le tableau ppRasPort0 .

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 peut être le code d’erreur suivant.

Valeur Signification
NERR _ ItemNotFound
Aucun port ne peut être énuméré. Cela peut être dû au fait que tous les ports configurés sur le serveur sont actuellement utilisés pour la numérotation.

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

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

_Port RAS _ 0

RasAdminFreeBuffer