Função MprAdminInterfaceSetInfo (mprapi.h)
A função MprAdminInterfaceSetInfo define informações para uma interface especificada em um servidor especificado.
Sintaxe
DWORD MprAdminInterfaceSetInfo(
[in] MPR_SERVER_HANDLE hMprServer,
[in] HANDLE hInterface,
[in] DWORD dwLevel,
[in] LPBYTE lpbBuffer
);
Parâmetros
[in] hMprServer
Manipule para o roteador a ser consultado. Esse identificador é obtido de uma chamada anterior para MprAdminServerConnect.
[in] hInterface
Manipule para a interface obtida por uma chamada anterior para MprAdminInterfaceCreate.
[in] dwLevel
Um valor DWORD que descreve o formato no qual as informações são estruturadas no parâmetro lpbBuffer . Os valores aceitáveis para dwLevel incluem 0, 1, 2 e 3, conforme listado na tabela a seguir.
Valor | Formato de estrutura |
---|---|
0 | MPR_INTERFACE_0 |
1 | MPR_INTERFACE_1 |
2 | MPR_INTERFACE_2 |
3 | Windows Server 2008 ou posterior: MPR_INTERFACE_3 |
[in] lpbBuffer
Um ponteiro para um MPR_INTERFACE_0, MPR_INTERFACE_1,
MPR_INTERFACE_2 ou estrutura MPR_INTERFACE_3 . O parâmetro dwLevel indica o tipo de estrutura.
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.
Valor | Significado |
---|---|
|
O aplicativo de chamada não tem privilégios suficientes. |
|
O valor hInterface é inválido. |
|
O parâmetro lplpbBuffer é NULL. |
|
Recursos insuficientes para concluir a operação. |
|
O valor dwLevel é inválido. |
Comentários
A função MprAdminInterfaceSetInfo dá suporte à estrutura MPR_INTERFACE_2 . No entanto, MprConfigInterfaceSetInfo não. Para fazer alterações persistentes em uma interface de discagem de demanda, chame MprAdminInterfaceSetInfo com MPR_INTERFACE_2 e chame MprConfigInterfaceSetInfo com MPR_INTERFACE_0 ou MPR_INTERFACE_1.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Nenhum compatível |
Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
Plataforma de Destino | Windows |
Cabeçalho | mprapi.h |
Biblioteca | Mprapi.lib |
DLL | Mprapi.dll |