Funzione MprAdminInterfaceSetCustomInfoEx (mprapi.h)

Articolo
02/29/2024

Imposta la configurazione personalizzata specifica del tunnel per un'interfaccia di composizione della richiesta specificata in un server specificato.

Sintassi

DWORD MprAdminInterfaceSetCustomInfoEx(
  [in] MPR_SERVER_HANDLE    hMprServer,
  [in] HANDLE               hInterface,
  [in] PMPR_IF_CUSTOMINFOEX pCustomInfo
);

Parametri

[in] hMprServer

Handle per il router su cui eseguire una query. Questo handle viene ottenuto da una chiamata precedente alla funzione MprAdminServerConnect .

[in] hInterface

Handle per l'interfaccia. Questo handle viene ottenuto da una chiamata precedente alla funzione MprAdminInterfaceCreate o alla funzione MprAdminInterfaceGetHandle .

[in] pCustomInfo

Puntatore a una struttura MPR_IF_CUSTOMINFOEX che contiene una configurazione personalizzata specifica del tunnel.

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.

Codice restituito	Descrizione
ERROR_ACCESS_DENIED	L'applicazione chiamante non dispone di privilegi sufficienti.
ERROR_INVALID_HANDLE	Il valore hInterface non è valido.
ERROR_INVALID_PARAMETER	Il parametro pCustomInfo è NULL o il tipo di interfaccia non è ROUTER_IF_TYPE_FULL_ROUTER.
ERROR_NOT_ENOUGH_MEMORY	Risorse insufficienti per completare l'operazione.

Commenti

Se è necessario eliminare la configurazione personalizzata per il tunnel IKEv2 di un'interfaccia, chiamare la funzione MprAdminInterfaceSetCustomInfoEx con il membro dwFlags della struttura MPR_IF_CUSTOMINFOEX impostata su zero.

Se è necessario eliminare la modalità principale IKEv2 e la configurazione dei criteri in modalità rapida per un'interfaccia, impostare il parametro customPolicy del membro customIkev2Config in MPR_IF_CUSTOMINFOEX struttura su NULL.

Se è necessario eliminare il certificato configurato per essere usato durante la negoziazione sa in modalità principale IKEv2, impostare il membro cbData di certificateName nel membro customIkev2Config della struttura MPR_IF_CUSTOMINFOEX su 0.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2012 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mprapi.h
Libreria	Mprapi.lib
DLL	Mprapi.dll

Vedi anche

Funzioni di amministrazione router

Informazioni di riferimento sulla gestione dei router

Condividi tramite