Informazioni sull'amministrazione del server e della porta RAS
Le funzioni di amministrazione del server RAS ottengono informazioni su un server RAS specificato e sulle relative porte. Queste funzioni vengono usate anche per terminare una connessione in una porta del server RAS specificata.
La funzione MprAdminServerGetInfo restituisce una struttura MPR_SERVER_0 che contiene informazioni sulla configurazione di un server RAS. Le informazioni restituite includono il numero di porte attualmente disponibili per le connessioni, il numero di porte attualmente in uso e il numero di versione del server.
La funzione MprAdminPortEnum recupera una matrice di strutture RAS_PORT_0 . Ogni struttura contiene informazioni per una delle porte configurate in un server RAS. Le informazioni per ogni porta includono:
- Nome della porta
- Informazioni sul dispositivo collegato alla porta
- Se il server RAS associato alla porta è un server Windows NT/Windows 2000 Server
- Indica se la porta è attualmente in uso e, se è, informazioni sulla connessione
Per ottenere le porte in uso da una connessione specifica, passare MprAdminPortEnum a tale connessione nel parametro hConnection . Per ottenere un handle a una connessione, usare la funzione MprAdminConnectionEnum . In alternativa, se è stata implementata una DLL di amministrazione RAS, le funzioni MprAdminAcceptNewConnection e MprAdminAcceptNewConnection2 ricevono un handle per ogni nuova connessione al momento della creazione della connessione.
È possibile chiamare la funzione MprAdminPortGetInfo per ottenere informazioni aggiuntive su una porta specificata in un server RAS. Questa funzione restituisce una struttura RAS_PORT_1 che contiene una struttura RAS_PORT_0 e informazioni aggiuntive sullo stato corrente della porta. La funzione RasAdminPortGetInfo restituisce anche una matrice di strutture RAS_PARAMETERS che descrivono i valori di chiavi specifiche dei supporti associati alla porta. Una struttura RAS_PARAMETERS usa un valore dell'enumerazione RAS_PARAMS_FORMAT per indicare il formato del valore per ogni chiave specifica del supporto.
La funzione MprAdminPortGetInfo restituisce anche una struttura RAS_PORT_STATISTICS che contiene vari contatori statistici per la connessione corrente, se presente, sulla porta. Per una porta che fa parte di una connessione multilink, MprAdminPortGetInfo restituisce statistiche per la singola porta e le statistiche cumulative per tutte le porte coinvolte nella connessione. È possibile usare la funzione MprAdminPortClearStats per reimpostare i contatori delle statistiche per la porta. La funzione MprAdminPortDisconnect disconnette una porta in uso.
Usare la funzione MprAdminBufferFree per liberare memoria allocata dalle funzioni MprAdminPortEnum e MprAdminPortGetInfo. Usare la funzione MprAdminGetErrorString per ottenere una stringa che descrive un codice di errore RAS restituito da una delle funzioni di amministrazione del server RAS (RasAdmin).