structure RAS_PORT_0

Article
06/13/2023

[Cette version de la structure RAS_PORT_0 n’est pas prise en charge à partir de Windows Vista. Utilisez plutôt le RAS_PORT_0 plus récent défini dans mprapi.h.]

La structure RAS_PORT_0 contient des informations qui décrivent un port RAS.

Syntaxe

typedef struct _RAS_PORT_0 {
  WCHAR wszPortName[RASSAPI_MAX_PORT_NAME];
  WCHAR wszDeviceType[RASSAPI_MAX_DEVICETYPE_NAME];
  WCHAR wszDeviceName[RASSAPI_MAX_DEVICE_NAME];
  WCHAR wszMediaName[RASSAPI_MAX_MEDIA_NAME];
  DWORD reserved;
  DWORD Flags;
  WCHAR wszUserName[UNLEN + 1];
  WCHAR wszComputer[NETBIOS_NAME_LEN];
  DWORD dwStartSessionTime;
  WCHAR wszLogonDomain[DNLEN + 1];
  BOOL  fAdvancedServer;
} RAS_PORT_0, *PRAS_PORT_0;

Membres

wszPortName

Chaîne Unicode terminée par null qui spécifie le nom du port, par exemple « COM1 ».

wszDeviceType

Chaîne Unicode terminée par null qui spécifie le type de l’appareil sur lequel la connexion a été établie, par exemple modem ou ISDN. La liste des types d’appareils qui peuvent être spécifiés dans ce membre inclut tous les types d’appareils installés sur le serveur, y compris les appareils tiers.

wszDeviceName

Chaîne Unicode terminée par null qui spécifie le nom de l’appareil sur lequel la connexion a été établie, par exemple « Hayes 9600 » ou « PCIMACISDN1 ».

wszMediaName

Spécifie une chaîne Unicode terminée par null qui spécifie le nom du média utilisé pour la connexion, tel que rasser ou rastapi.

reserved

Réservé.

Indicateurs

Spécifie un ensemble d’indicateurs de bits qui spécifient la nature de la connexion établie sur ce port. Ce membre peut être une combinaison des indicateurs suivants.

Valeur	Signification
GATEWAY_ACTIVE	Si cet indicateur est défini, la passerelle NetBIOS est active sur le serveur.
MESSENGER_PRESENT	Si cet indicateur est défini, le service de messagerie s’exécute sur le client distant.
PORT_MULTILINKED	Si cet indicateur est défini, le port est multilinké avec d’autres ports. Utilisez ces informations pour afficher le status de connexion en tant que port multilinké. Pour un port multilinké, la structure RAS_PORT_STATISTICS contient deux ensembles de statistiques : l’un pour le port seul et l’autre pour les ports combinés dans la connexion multilink.
PPP_CLIENT	Si cet indicateur est défini, le client distant s’est connecté à l’aide de PPP. Si cet indicateur n’est pas défini, le client distant s’est connecté à l’aide du protocole AMB.
REMOTE_LISTEN	Si cet indicateur est défini, le paramètre RemoteListen de la passerelle NetBIOS est défini sur 1 sur le serveur.
USER_AUTHENTICATED	Si cet indicateur est défini, un client distant est connecté au serveur et l’utilisateur a été authentifié. Vérifiez cet indicateur pour vous assurer qu’un client est effectivement connecté à un port.

Si les indicateurs MESSENGER_PRESENT, GATEWAY_ACTIVE et REMOTE_LISTEN sont définis, utilisez le service de messagerie pour envoyer un message administratif au client distant. Si MESSENGER_PRESENT et REMOTE_LISTEN sont définis, mais GATEWAY_ACTIVE ne l’est pas, envoyez des messages au client uniquement à partir du serveur RAS auquel le client est connecté.

wszUserName

Chaîne Unicode terminée par null qui spécifie le nom de l’utilisateur distant connecté à ce port.

wszComputer

Chaîne Unicode terminée par null qui spécifie le nom de l’ordinateur client distant.

dwStartSessionTime

Spécifie l’heure, en secondes à partir du 1er janvier 1970, pendant laquelle le client s’est connecté au serveur RAS sur ce port. Utilisez les fonctions d’heure standard pour mettre en forme cette valeur pour l’affichage.

wszLogonDomain

Spécifie une chaîne Unicode terminée par null qui spécifie le nom du domaine sur lequel l’utilisateur distant a été authentifié. Cette chaîne est le nom de domaine uniquement, sans préfixe « \\ ».

fAdvancedServer

Spécifie un indicateur différent de zéro si le serveur RAS associé à ce port est un serveur avancé tel que Windows 2000 Advanced Server. Utilisez ces informations pour déterminer le nom du serveur qui possède la base de données de compte d’utilisateur. Si le serveur RAS est un serveur avancé, obtenez le nom du serveur de compte d’utilisateur en concaténant le préfixe « \\ » au nom retourné dans le membre wszLogonDomain . En effet, pour un serveur avancé, le nom de domaine d’ouverture de session local est identique au nom du serveur. Si le serveur RAS est une station de travail, utilisez la fonction RasAdminGetUserAccountServer pour obtenir le nom du serveur de compte d’utilisateur.

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_PORT_1
RAS_PORT_STATISTICS
RasAdminGetUserAccountServer
RasAdminPortEnum

Share via