Partager via


RAS_PORT_1 structure

[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