Fonction RasAdminPortGetInfo
[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 MprAdminPortGetInfo .]
La fonction RasAdminPortGetInfo récupère des informations sur un port spécifié sur un serveur spécifié.
Syntaxe
DWORD RasAdminPortGetInfo(
_In_ const WCHAR *lpszServer,
_In_ const WCHAR *lpszPort,
_Out_ RAS_PORT_1 *pRasPort1,
_Out_ RAS_PORT_STATISTICS *pRasStats,
_Out_ RAS_PARAMETERS **ppRasParams
);
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.
-
lpszPort [in]
-
Pointeur vers une chaîne Unicode terminée par null qui spécifie le nom du port sur le serveur.
-
pRasPort1 [out]
-
Pointeur vers la structure RAS_PORT_1 que la fonction remplit avec des informations sur l’état du port.
-
pRasStats [out]
-
Pointeur vers la structure RAS_PORT_STATISTICS que la fonction remplit avec des statistiques sur le port.
-
ppRasParams [out]
-
Pointeur vers une variable pointeur qui reçoit l’adresse d’un tableau de structures RAS_PARAMETERS . Chaque structure contient le nom d’une clé spécifique au média, telle que MAXCONNECTBPS, et sa valeur associée. Lorsque l’application a terminé cette mémoire, libérez-la en appelant la fonction RasAdminFreeBuffer .
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 l’un des codes d’erreur suivants.
| Valeur | Signification |
|---|---|
|
Le port spécifié n’est pas valide. |
|
Mémoire insuffisante pour allouer une mémoire tampon pour le tableau ppRasParams . |
Il n’existe aucune information d’erreur étendue pour cette fonction ; n’appelez pas GetLastError.
Spécifications
| 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 |
|