RAS_PORT_0 struttura
[Questa versione della struttura RAS_PORT_0 non è supportata a partire da Windows Vista. Usare invece il RAS_PORT_0 più recente definito in mprapi.h.
La struttura RAS_PORT_0 contiene informazioni che descrivono una porta RAS.
Sintassi
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;
Members
-
wszPortName
-
Stringa Unicode con terminazione null che specifica il nome della porta, ad esempio "COM1".
-
wszDeviceType
-
Stringa Unicode con terminazione null che specifica il tipo del dispositivo in cui è stata effettuata la connessione, ad esempio Modem o ISDN. L'elenco dei tipi di dispositivo che potrebbero essere specificati in questo membro include tutti i tipi di dispositivo installati nel server, inclusi i dispositivi di terze parti.
-
wszDeviceName
-
Stringa Unicode con terminazione null che specifica il nome del dispositivo in cui è stata effettuata la connessione, ad esempio "Hayes 9600" o "PCIMACISDN1".
-
wszMediaName
-
Specifica una stringa Unicode con terminazione null che specifica il nome del supporto utilizzato per la connessione, ad esempio rasser o rastapi.
-
Riservati
-
Riservato.
-
Flag
-
Specifica un set di flag di bit che specificano la natura della connessione effettuata su questa porta. Questo membro può essere una combinazione dei flag seguenti.
Valore Significato - GATEWAY_ACTIVE
Se questo flag è impostato, il gateway NetBIOS è attivo nel server. - MESSENGER_PRESENT
Se questo flag è impostato, il servizio messenger è in esecuzione nel client remoto. - PORT_MULTILINKED
Se questo flag è impostato, la porta è multilinkata con altre porte. Usare queste informazioni per visualizzare lo stato della connessione come porta multilink.
Per una porta multilinked, la struttura RAS_PORT_STATISTICS contiene due set di statistiche: uno per la porta sola e un altro per le porte combinate nella connessione multilink.- PPP_CLIENT
Se questo flag è impostato, il client remoto connesso con PPP. Se questo flag non è impostato, il client remoto è connesso usando il protocollo AMB. - REMOTE_LISTEN
Se questo flag è impostato, il parametro RemoteListen del gateway NetBIOS è impostato su 1 nel server. - USER_AUTHENTICATED
Se questo flag è impostato, un client remoto è connesso al server e l'utente è stato autenticato. Controllare questo flag per assicurarsi che un client sia effettivamente connesso a una porta. Se il MESSENGER_PRESENT, GATEWAY_ACTIVE e i flag di REMOTE_LISTEN vengono impostati, usare il servizio messenger per inviare un messaggio amministrativo al client remoto. Se MESSENGER_PRESENT e REMOTE_LISTEN vengono impostati, ma GATEWAY_ACTIVE non è, inviare messaggi al client solo dal server RAS a cui è connesso il client.
-
wszUserName
-
Stringa Unicode con terminazione null che specifica il nome dell'utente remoto connesso a questa porta.
-
wszComputer
-
Stringa Unicode con terminazione null che specifica il nome del computer client remoto.
-
dwStartSessionTime
-
Specifica l'ora, in secondi dal 1° gennaio 1970, che il client è connesso al server RAS su questa porta. Usare le funzioni di ora standard per formattare questo valore per la visualizzazione.
-
wszLogonDomain
-
Specifica una stringa Unicode con terminazione null che specifica il nome del dominio in cui è stato autenticato l'utente remoto. Questa stringa è solo il nome di dominio, senza prefisso "\\".
-
fAdvancedServer
-
Specifica un flag diverso da zero se il server RAS associato a questa porta è un server avanzato, ad esempio Windows 2000 Advanced Server. Usare queste informazioni per determinare il nome del server con il database dell'account utente. Se il server RAS è un server avanzato, ottenere il nome del server account utente concatenando il prefisso "\\" al nome restituito nel membro wszLogonDomain . Questo perché per un server avanzato il nome di dominio di accesso locale è uguale al nome del server. Se il server RAS è una workstation, usare la funzione RasAdminGetUserAccountServer per ottenere il nome del server account utente.
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 |
|