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	Rassapi.h

Vedi anche

Panoramica del servizio di accesso remoto (RAS)

Strutture di amministrazione del server RAS

RAS_PORT_1

RAS_PORT_STATISTICS

RasAdminGetUserAccountServer

RasAdminPortEnum