Compartir a través de

Función MprAdminInterfaceSetCustomInfoEx (mprapi.h)

  • Artículo

Establece la configuración personalizada específica del túnel para una interfaz de marcado de demanda especificada en un servidor especificado.

Sintaxis

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

Parámetros

[in] hMprServer

Identificador del enrutador que se va a consultar. Este identificador se obtiene mediante una llamada anterior a la función MprAdminServerConnect .

[in] hInterface

Identificador de la interfaz. Este identificador se obtiene mediante una llamada anterior a la función MprAdminInterfaceCreate o a la función MprAdminInterfaceGetHandle .

[in] pCustomInfo

Puntero a una estructura de MPR_IF_CUSTOMINFOEX que contiene una configuración personalizada específica del túnel.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es NO_ERROR. Si se produce un error en la función, el valor devuelto es uno de los siguientes códigos de error.

Código devuelto Descripción
ERROR_ACCESS_DENIED
 La aplicación que realiza la llamada no tiene privilegios suficientes.
ERROR_INVALID_HANDLE
 El valor hInterface no es válido.
ERROR_INVALID_PARAMETER
 El parámetro pCustomInfo es NULL o el tipo de interfaz no es ROUTER_IF_TYPE_FULL_ROUTER.
ERROR_NOT_ENOUGH_MEMORY
 No había recursos suficientes para completar la operación.

Comentarios

Si necesita eliminar la configuración personalizada para el túnel IKEv2 de una interfaz, llame a la función MprAdminInterfaceSetCustomInfoEx con el miembro dwFlags de la estructura MPR_IF_CUSTOMINFOEX establecida en cero.

Si necesita eliminar la configuración de directiva de modo principal y modo rápido de IKEv2 para una interfaz, establezca el parámetro customPolicy del miembro customIkev2Config en MPR_IF_CUSTOMINFOEX estructura en NULL.

Si necesita eliminar el certificado configurado para su uso durante la negociación sa del modo principal de IKEv2, establezca el miembro cbData de certificateName en el miembro customIkev2Config de MPR_IF_CUSTOMINFOEX estructura en 0.

Requisitos

Requisito Value
Cliente mínimo compatible No se admite ninguno
Servidor mínimo compatible Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado mprapi.h
Library Mprapi.lib
Archivo DLL Mprapi.dll

Consulte también

Funciones de administración del enrutador

Referencia de administración de enrutadores