Condividi tramite


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