Função MprAdminInterfaceDeviceSetInfo (mprapi.h)

Artigo
02/29/2024

O MprAdminInterfaceDeviceSetInfo cria ou modifica um dispositivo usado em uma interface de discagem de demanda do roteador.

Sintaxe

DWORD MprAdminInterfaceDeviceSetInfo(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] HANDLE            hInterface,
  [in] DWORD             dwIndex,
  [in] DWORD             dwLevel,
  [in] LPBYTE            lpbBuffer
);

Parâmetros

[in] hMprServer

Manipule para o roteador no qual executar essa chamada. Obtenha esse identificador chamando MprAdminServerConnect.

[in] hInterface

Manipule para a interface. Obtenha esse identificador de uma chamada anterior para MprAdminInterfaceCreate ou chamando MprAdminInterfaceEnum.

[in] dwIndex

Especifica o índice baseado em um do dispositivo. Uma interface de discagem de demanda multi-vinculada usa vários dispositivos.

[in] dwLevel

Um valor DWORD que descreve o formato no qual as informações são estruturadas no parâmetro lplpBuffer . Os valores aceitáveis para dwLevel incluem 0 ou 1 conforme listado na tabela a seguir.

Valor	Formato de estrutura
0	MPR_DEVICE_0
1	MPR_DEVICE_1

[in] lpbBuffer

Um ponteiro para uma estrutura de MPR_DEVICE_0 ou MPR_DEVICE_1 . 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
ERROR_ACCESS_DENIED	O aplicativo de chamada não tem privilégios suficientes.
ERROR_INVALID_HANDLE	O valor hInterface é inválido.
ERROR_INVALID_PARAMETER	O parâmetro lplpBuffer é NULL.
ERROR_NOT_ENOUGH_MEMORY	Recursos insuficientes para concluir a operação.
ERROR_NOT_SUPPORTED	O valor dwLevel é inválido.

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

Confira também

MPR_DEVICE_0

MPR_DEVICE_1

MprAdminInterfaceCreate

MprAdminInterfaceDeviceGetInfo

Compartilhar via