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
ERROR_ACCESS_DENIED	L'applicazione chiamante non dispone di privilegi sufficienti.
RPC_S_INVALID_BINDING	Questa funzione è stata chiamata con il parametro phMprServer uguale a NULL.
RPC_S_UNKNOWN_IF	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

Vedi anche

MprAdminServerDisconnect

Funzioni di amministrazione router

Informazioni di riferimento sulla gestione dei router