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 |
|