estructura de RAS_PORT_0

[Esta versión de la estructura de RAS_PORT_0 no se admite a partir de Windows Vista. Use la RAS_PORT_0 más reciente definida en mprapi.h en su lugar.

La estructura RAS_PORT_0 contiene información que describe un puerto RAS.

Sintaxis

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;

Miembros

wszPortName

Cadena Unicode terminada en null que especifica el nombre del puerto, como "COM1".

wszDeviceType

Cadena Unicode terminada en null que especifica el tipo del dispositivo en el que se realizó la conexión, como Módem o ISDN. La lista de tipos de dispositivo que se pueden especificar en este miembro incluye todos los tipos de dispositivo instalados en el servidor, incluidos los dispositivos de terceros.

wszDeviceName

Cadena Unicode terminada en null que especifica el nombre del dispositivo en el que se realizó la conexión, como "Hayes 9600" o "PCIMACISDN1".

wszMediaName

Especifica una cadena Unicode terminada en null que especifica el nombre de los medios utilizados para la conexión, como rasser o rastapi.

reserved

Reservado.

Marcas

Especifica un conjunto de marcas de bits que especifican la naturaleza de la conexión realizada en este puerto. Este miembro puede ser una combinación de las marcas siguientes.

Valor	Significado
GATEWAY_ACTIVE	Si se establece esta marca, la puerta de enlace netBIOS está activa en el servidor.
MESSENGER_PRESENT	Si se establece esta marca, el servicio messenger se ejecuta en el cliente remoto.
PORT_MULTILINKED	Si se establece esta marca, el puerto está multivinculado con otros puertos. Use esta información para mostrar el estado de conexión como un puerto multivinculado. En el caso de un puerto multivinculado, la estructura RAS_PORT_STATISTICS contiene dos conjuntos de estadísticas: uno solo para el puerto y otro para los puertos combinados de la conexión de varios vínculos.
PPP_CLIENT	Si se establece esta marca, el cliente remoto conectado mediante PPP. Si no se establece esta marca, el cliente remoto conectado mediante el protocolo AMB.
REMOTE_LISTEN	Si se establece esta marca, el parámetro RemoteListen de la puerta de enlace netBIOS se establece en 1 en el servidor.
USER_AUTHENTICATED	Si se establece esta marca, un cliente remoto está conectado al servidor y el usuario se ha autenticado. Compruebe esta marca para asegurarse de que un cliente está realmente conectado a un puerto.

Si se establecen las marcas MESSENGER_PRESENT, GATEWAY_ACTIVE y REMOTE_LISTEN, use el servicio messenger para enviar un mensaje administrativo al cliente remoto. Si se establecen MESSENGER_PRESENT y REMOTE_LISTEN, pero GATEWAY_ACTIVE no es , envíe mensajes al cliente solo desde el servidor RAS al que está conectado el cliente.

wszUserName

Cadena Unicode terminada en null que especifica el nombre del usuario remoto conectado a este puerto.

wszComputer

Cadena Unicode terminada en null que especifica el nombre del equipo cliente remoto.

dwStartSessionTime

Especifica el tiempo, en segundos desde el 1 de enero de 1970, que el cliente se ha conectado al servidor RAS en este puerto. Use las funciones de hora estándar para dar formato a este valor para su presentación.

wszLogonDomain

Especifica una cadena Unicode terminada en null que especifica el nombre del dominio en el que se autenticó el usuario remoto. Esta cadena es solo el nombre de dominio, sin prefijo "\\".

fAdvancedServer

Especifica una marca que no es cero si el servidor RAS asociado a este puerto es un servidor avanzado como Windows 2000 Advanced Server. Use esta información para determinar el nombre del servidor que tiene la base de datos de cuentas de usuario. Si el servidor RAS es un servidor avanzado, obtenga el nombre del servidor de cuentas de usuario concatenando el prefijo "\\" al nombre devuelto en el miembro wszLogonDomain . Esto se debe a que para un servidor avanzado, el nombre de dominio de inicio de sesión local es el mismo que el nombre del servidor. Si el servidor RAS es una estación de trabajo, use la función RasAdminGetUserAccountServer para obtener el nombre del servidor de cuentas de usuario.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Fin de compatibilidad de cliente	Windows XP
Fin de compatibilidad de servidor	Windows Server 2003
Encabezado	Rassapi.h

Consulte también

Información general sobre el servicio de acceso remoto (RAS)

Estructuras de administración del servidor RAS

RAS_PORT_1

RAS_PORT_STATISTICS

RasAdminGetUserAccountServer

RasAdminPortEnum