Funzione MprAdminInterfaceConnect (mprapi.h)

Articolo
08/24/2023

La funzione MprAdminInterfaceConnect crea una connessione all'interfaccia WAN specificata.

Sintassi

DWORD MprAdminInterfaceConnect(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] HANDLE            hInterface,
  [in] HANDLE            hEvent,
  [in] BOOL              fSynchronous
);

Parametri

[in] hMprServer

Gestire il router su cui eseguire questa chiamata. Ottenere questo handle chiamando MprAdminServerConnect.

[in] hInterface

Handle per l'interfaccia. Questo handle viene ottenuto da una chiamata precedente a MprAdminInterfaceCreate.

[in] hEvent

Handle per un evento segnalato dopo il tentativo di connessione dell'interfaccia. La funzione avvia il tentativo di connessione e restituisce immediatamente. Dopo aver segnalato l'evento, è possibile ottenere il risultato del tentativo di connessione chiamando MprAdminInterfaceGetInfo.

Se questo parametro è NULL e fBlocking è TRUE, questa chiamata è sincrona, ovvero la funzione non restituisce fino al completamento del tentativo di connessione.

L'applicazione chiamante deve specificare NULL per questo parametro, se hMprServer specifica un router remoto.

[in] fSynchronous

Se hEvent è NULL e questo parametro è impostato su TRUE, la funzione non restituisce fino al completamento del tentativo di connessione.

Se hEvent è NULL e questo parametro è impostato su FALSE, la funzione restituirà immediatamente. Un valore restituito PENDING indica che il tentativo di connessione è stato avviato correttamente.

Se hEvent non è NULL, questo parametro viene ignorato.

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.
ERROR_ALREADY_CONNECTING	Una connessione è già in corso in questa interfaccia.
ERROR_DDM_NOT_RUNNING	Demand Dial Manager (DDM) non è in esecuzione.
ERROR_INTERFACE_DISABLED	L'interfaccia è attualmente disabilitata.
ERROR_INTERFACE_HAS_NO_DEVICES	Nessun adattatore disponibile per questa interfaccia.
ERROR_INVALID_HANDLE	Il valore hInterface non è valido.
ERROR_SERVICE_IS_PAUSED	Il servizio Di composizione richiesta è attualmente sospeso.
IN SOSPESO	L'interfaccia è in fase di connessione. L'applicazione chiamante deve attendere l'handle hEvent , se ne è stata specificata una. Dopo aver segnalato l'evento, è possibile ottenere lo stato della connessione e qualsiasi errore associato chiamando MprAdminInterfaceGetInfo.

Commenti

La tabella seguente riepiloga la relazione tra hEvent e fBlocking.

hEvent	fBlocking	Risultato
Handle eventi	Ignorato	La chiamata restituisce immediatamente. Un valore restituito PENDING indica che il tentativo è stato avviato correttamente. Attendere hEvent. Quando viene segnalato hEvent , usare MprAdminInterfaceGetInfo per determinare l'esito positivo o negativo del tentativo di connessione.
NULL	TRUE	La chiamata non restituisce fino al completamento del tentativo di connessione.
NULL	FALSE	La chiamata restituisce immediatamente. Un valore restituito PENDING indica che il tentativo è stato avviato correttamente.

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