Funzione MprAdminServerConnect (mprapi.h)
La funzione MprAdminServerConnect stabilisce una connessione a un router allo scopo di amministrare tale router. Chiamare questa funzione prima di effettuare altre chiamate al server. Usare l'handle restituito nelle chiamate successive per amministrare le interfacce nel server.
Sintassi
DWORD MprAdminServerConnect(
[in, optional] LPWSTR lpwsServerName,
[out] MPR_SERVER_HANDLE *phMprServer
);
Parametri
[in, optional] lpwsServerName
Puntatore a una stringa Unicode con terminazione Null che specifica il nome del server remoto. Se questo parametro è NULL, la funzione restituisce un handle al computer locale.
[out] phMprServer
Puntatore a una variabile HANDLE che riceve un handle per il server. Usare questo handle nelle chiamate successive per amministrare il server.
Valore restituito
Se la funzione ha esito positivo, il valore restituito viene NO_ERROR.
Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.
| Valore | Significato |
|---|---|
|
L'applicazione chiamante non dispone di privilegi sufficienti. |
|
Questa funzione è stata chiamata con il parametro phMprServer uguale a NULL. |
|
Il computer specificato non esegue il servizio Routing e RAS. |
Commenti
È necessario usare MprAdminIsServiceRunning per determinare lo stato del servizio RRAS nel server remoto. MprAdminServerConnect non esegue query sul servizio RRAS quando si stabilisce una connessione.
Requisiti
| Client minimo supportato | Nessuno supportato |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | mprapi.h |
| Libreria | Mprapi.lib |
| DLL | Mprapi.dll |