Configurar função de retorno de chamada

A função Configurar configura o especialista na DLL especializada.

O especialista deve implementar a função Configurar . Quando a chamada de função é recebida, o especialista exibe uma caixa de diálogo que permite que o usuário altere qualquer item configurável.

Sintaxe

BOOL WINAPI Configure(
  _In_    HEXPERTKEY         hExpertKey,
  _Inout_ PEXPERTCONFIG      *ppConfig,
  _In_    PEXPERTSTARTUPINFO pExpertStartupInfo,
  _In_    DWORD              StartupFlags,
  _In_    HWND               hWnd
);

Parâmetros

hExpertKey [in]

Identificador de especialista exclusivo.

O identificador exclusivo é passado novamente em todas as funções específicas do Monitor de Rede específicas do especialista. Lembre-se de que o identificador pode não ser a mesma chave especializada que a passada para a função Executar . Não armazene a chave de especialista da chamada Configurar.

ppConfig [in, out]

Um ponteiro para um ponteiro para uma estrutura EXPERTCONFIG na entrada.

Após uma saída bem-sucedida, a estrutura EXPERTCONFIG referenciada contém os novos dados de configuração.

pExpertStartupInfo [in]

Um ponteiro para o elemento de captura com foco quando o especialista começou.

StartupFlags [in]

Os sinalizadores que indicam como o especialista deve usar o parâmetro pExpertStartupInfo . O único sinalizador definido é EXPERT_STARTUP_FLAG_USE_STARTUP_DATA_OVER_CONFIG_DATA. O sinalizador indica que o especialista usará o parâmetro pExpertStartupInfo em vez do parâmetro ppConfig que passou. Normalmente, você define o sinalizador quando inicia o especialista em um menu de contexto.

hWnd [in]

Um identificador para a janela pai. Use o identificador para abrir uma caixa de diálogo.

Valor retornado

Se a função for bem-sucedida (ou seja, se houver uma configuração atual), o valor retornado será TRUE.

Se a função não for bem-sucedida, o valor retornado será FALSE.

Comentários

O Monitor de Rede chama a função Configurar com a configuração atual do especialista, se houver uma. O especialista exibe uma caixa de diálogo, com a qual você pode alterar qualquer item configurável.

Quando ppConfig é passado e o Monitor de Rede não tem uma configuração armazenada para o especialista especificado, o valor do parâmetro pode ser NULL. Nesse caso, a função Configurar pressupõe valores padrão embutidos em código (ou, usa as informações de inicialização) para abrir a caixa de diálogo.

Os dados de configuração também podem ser NULL quando a função Configurar retorna e um NULL foi passado. Essa situação ocorre quando o Monitor de Rede não tem um padrão armazenado e o usuário pressiona Cancelar.

O início da estrutura de dados EXPERTCONFIG inclui uma seção Privada que armazena as informações de tamanho da estrutura. O tamanho da estrutura EXPERTCONFIG deve incluir o comprimento DWORD reservado que aparece no início da estrutura. Por exemplo, se os dados de configuração exigirem 20 bytes de espaço de armazenamento, aloque 24 bytes para armazenar os dados. Se um ppConfig for NULL, a função Configurar chamará a função ExpertAllocMemory para alocar uma nova configuração que seja o tamanho correto. Se o buffer não for suficiente para armazenar os dados de especialistas, o especialista deverá chamar a função ExpertReallocMemory .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	Netmon.h