Compartilhar via

Função MprAdminInterfaceSetCustomInfoEx (mprapi.h)

  • Artigo

Define a configuração personalizada específica do túnel para uma interface de discagem de demanda especificada em um servidor especificado.

Sintaxe

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

Parâmetros

[in] hMprServer

O identificador para o roteador a ser consultado. Esse identificador é obtido por uma chamada anterior para a função MprAdminServerConnect .

[in] hInterface

O identificador para a interface. Esse identificador é obtido por uma chamada anterior para a função MprAdminInterfaceCreate ou a função MprAdminInterfaceGetHandle .

[in] pCustomInfo

Um ponteiro para uma estrutura de MPR_IF_CUSTOMINFOEX que contém a configuração personalizada específica do túnel.

Retornar valor

Se a função for bem-sucedida, o valor retornado será NO_ERROR. Se a função falhar, o valor retornado será um dos seguintes códigos de erro.

Código de retorno Descrição
ERROR_ACCESS_DENIED
 O aplicativo de chamada não tem privilégios suficientes.
ERROR_INVALID_HANDLE
 O valor hInterface não é válido.
ERROR_INVALID_PARAMETER
 O parâmetro pCustomInfo é NULL ou o tipo de interface não é ROUTER_IF_TYPE_FULL_ROUTER.
ERROR_NOT_ENOUGH_MEMORY
 Não havia recursos suficientes para concluir a operação.

Comentários

Se você precisar excluir a configuração personalizada para o túnel IKEv2 de uma interface, chame a função MprAdminInterfaceSetCustomInfoEx com o membro dwFlags da estrutura MPR_IF_CUSTOMINFOEX definida como zero.

Se você precisar excluir o modo de main IKEv2 e a configuração de política de modo rápido para uma interface, defina o parâmetro customPolicy do membro customIkev2Config em MPR_IF_CUSTOMINFOEX estrutura como NULL.

Se você precisar excluir o certificado configurado para ser usado durante a negociação sa do modo de main IKEv2, defina o membro cbData de certificateName no membro customIkev2Config de MPR_IF_CUSTOMINFOEX estrutura como 0.

Requisitos

Requisito Valor
Cliente mínimo com suporte Nenhum compatível
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho mprapi.h
Biblioteca Mprapi.lib
DLL Mprapi.dll

Confira também

Funções de administração do roteador

Referência de gerenciamento de roteador