Fonction RasAdminPortGetInfo

Article
06/13/2023

[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
ERROR_DEV_NOT_EXIST	Le port spécifié n’est pas valide.
ERROR_NOT_ENOUGH_MEMORY	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	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
RAS_PARAMETERS
RAS_PORT_1
RAS_PORT_STATISTICS
RasAdminFreeBuffer

Partager via