Fonction RasAdminPortEnum
[Cette fonction est fournie uniquement pour la compatibilité descendante avec Windows NT Server 4.0. Il retourne ERROR_CALL_NOT_IMPLEMENTED 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 RAS_PORT_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 [in]
-
Pointeur vers une chaîne Unicode terminée par null qui spécifie le nom du serveur RAS. Spécifiez le nom avec les caractères « \\ », sous la forme : \\servername.
-
ppRasPort0 [out]
-
Pointeur vers une variable qui reçoit un pointeur vers une mémoire tampon qui contient un tableau de structures RAS_PORT_0 . Une fois la mémoire terminée, libérez-la en appelant la fonction RasAdminFreeBuffer .
-
pcEntriesRead [out]
-
Pointeur vers une variable 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 ERROR_SUCCESS.
Si la fonction échoue, la valeur de retour peut être le code d’erreur suivant.
| Valeur | Signification |
|---|---|
|
Aucun port n’a pu ê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’existe aucune information d’erreur étendue pour cette fonction ; n’appelez pas 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 |
|
| Bibliothèque |
|
| DLL |
|