RAS_PORT_1 structure

Article
06/13/2023

[Cette version de la structure RAS_PORT_1 n’est pas prise en charge à partir de Windows Vista. Utilisez plutôt les RAS_PORT_1 plus récents définis dans mprapi.h.]

La structure RAS_PORT_1 contient des informations sur un port RAS.

Syntaxe

typedef struct _RAS_PORT_1 {
  RAS_PORT_0                rasport0;
  DWORD                     LineCondition;
  DWORD                     HardwareCondition;
  DWORD                     LineSpeed;
  WORD                      NumStatistics;
  WORD                      NumMediaParms;
  DWORD                     SizeMediaParms;
  RAS_PPP_PROJECTION_RESULT ProjResult;
} RAS_PORT_1, *PRAS_PORT_1;

Membres

rasport0

Spécifie une structure RAS_PORT_0 qui contient des informations sur le port, telles que le nom du port, le nom de l’utilisateur distant connecté au port, etc.

LineCondition

Spécifie l’état du port. Ce membre peut être l’une des valeurs suivantes.

Valeur	Signification
RAS_PORT_NON_OPERATIONAL	Le port n’est pas opérationnel. Vérifiez dans le journal des événements les erreurs signalées par le serveur.
RAS_PORT_DISCONNECTED	Le port est actuellement déconnecté.
RAS_PORT_CALLING_BACK	Le serveur RAS appelle le client RAS.
RAS_PORT_LISTENING	Le port attend qu’un client appelle.
RAS_PORT_AUTHENTICATING	Le serveur est en cours d’authentification du client distant.
RAS_PORT_AUTHENTICATED	Le client distant est maintenant authentifié.
RAS_PORT_INITIALIZING	L’appareil attaché au port est en cours d’initialisation. L’état du port passe à RAS_PORT_LISTENING une fois l’initialisation terminée.

HardwareCondition

Spécifie l’une des valeurs suivantes pour indiquer l’état de l’appareil attaché au port.

Valeur	Signification
RAS_MODEM_OPERATIONAL	Le modem attaché à ce port est opérationnel et prêt à recevoir des appels client.
RAS_MODEM_HARDWARE_FAILURE	Le modem attaché à ce port rencontre un problème matériel.

LineSpeed

Spécifie la vitesse, en bits par seconde, avec laquelle l’ordinateur peut communiquer avec le port.

NumStatistics

Ce membre n’est pas utilisé. Les fonctions d’administration RAS, telles que la fonction RasAdminPortGetInfo , utilisent la structure RAS_PORT_STATISTICS pour retourner des statistiques de port.

NumMediaParms

Spécifie le nombre de paramètres spécifiques au média pour ce port. Pour le média série, il s’agit généralement du nombre de valeurs qui apparaissent dans le fichier SERIAL.INI.

SizeMediaParms

Spécifie la taille, en octets, de la mémoire tampon requise pour tous les paramètres spécifiques au média. La fonction RasAdminPortGetInfo retourne une mémoire tampon qui contient un tableau de structures RAS_PARAMETERS avec les paramètres de média et les valeurs du port.

ProjResult

Structure RAS_PPP_PROJECTION_RESULT qui spécifie les informations de projection PPP pour ce port. Cette structure fournit des informations pour chaque protocole négocié lorsqu’un client RAS se connecte à un serveur.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Fin de la prise en charge des clients	Windows XP
Fin de la prise en charge des serveurs	Windows Server 2003
En-tête	Rassapi.h

Voir aussi

Vue d’ensemble du service d’accès à distance (RAS)
Structures d’administration du serveur RAS
RAS_PARAMETERS
RAS_PORT_0
RAS_PORT_STATISTICS
RAS_PPP_PROJECTION_RESULT
RasAdminAcceptNewConnection
RasAdminConnectionHangupNotification
RasAdminPortGetInfo

Share via