RAS_PORT_1 struttura

[Questa versione della struttura RAS_PORT_1 non è supportata a partire da Windows Vista. Usare invece il RAS_PORT_1 più recente definito in mprapi.h.

La struttura RAS_PORT_1 contiene informazioni su una porta RAS.

Sintassi

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;

Members

rasport0

Specifica una struttura RAS_PORT_0 che contiene informazioni sulla porta, ad esempio il nome della porta, il nome dell'utente remoto connesso alla porta e così via.

LineCondition

Specifica lo stato della porta. Questo membro può essere uno dei valori seguenti.

Valore Significato
RAS_PORT_NON_OPERATIONAL
La porta non è operativa. Controllare il registro eventi per gli errori segnalati dal server.
RAS_PORT_DISCONNECTED
La porta è attualmente disconnessa.
RAS_PORT_CALLING_BACK
Il server RAS sta richiamando il client RAS.
RAS_PORT_LISTENING
La porta è in attesa di una chiamata di un client.
RAS_PORT_AUTHENTICATING
Il server si trova nel processo di autenticazione del client remoto.
RAS_PORT_AUTHENTICATED
Il client remoto è ora autenticato.
RAS_PORT_INITIALIZING
Il dispositivo collegato alla porta viene inizializzato. Lo stato della porta verrà modificato in RAS_PORT_LISTENING al termine dell'inizializzazione.

HardwareCondition

Specifica uno dei valori seguenti per indicare lo stato del dispositivo collegato alla porta.

Valore Significato
RAS_MODEM_OPERATIONAL
Il modem collegato a questa porta è operativo ed è pronto per ricevere chiamate client.
RAS_MODEM_HARDWARE_FAILURE
Il modem collegato a questa porta presenta un problema hardware.

LineSpeed

Specifica la velocità, in bit al secondo, con cui il computer può comunicare con la porta.

NumStatistics

Questo membro non viene usato. Le funzioni di amministrazione RAS, ad esempio la funzione RasAdminPortGetInfo , usano la struttura RAS_PORT_STATISTICS per restituire le statistiche sulle porte.

NumMediaParms

Specifica il numero di parametri specifici del supporto per questa porta. Per i supporti seriali, questo è in genere il numero di valori visualizzati nel file SERIAL.INI.

SizeMediaParms

Specifica le dimensioni, in byte, del buffer necessario per tutti i parametri specifici del supporto. La funzione RasAdminPortGetInfo restituisce un buffer che contiene una matrice di strutture RAS_PARAMETERS con i parametri e i valori multimediali per la porta.

ProjResult

Struttura RAS_PPP_PROJECTION_RESULT che specifica le informazioni sulla proiezione PPP per questa porta. Questa struttura fornisce informazioni per ogni protocollo negoziato quando un client RAS si connette a un server.

Requisiti

Requisito Valore
Client minimo supportato
Windows 2000 Professional [solo app desktop]
Server minimo supportato
Windows 2000 Server [solo app desktop]
Fine del supporto client
Windows XP
Fine del supporto server
Windows Server 2003
Intestazione
Rassapi.h

Vedi anche

Panoramica del servizio di accesso remoto (RAS)

Strutture di amministrazione del server RAS

RAS_PARAMETERS

RAS_PORT_0

RAS_PORT_STATISTICS

RAS_PPP_PROJECTION_RESULT

RasAdminAcceptNewConnection

RasAdminConnectionHangupNotification

RasAdminPortGetInfo