Função SnmpExtensionMonitor (snmp.h)
[O SNMP está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele poderá ser alterado ou ficar indisponível em versões subsequentes. Em vez disso, use o Gerenciamento Remoto do Windows, que é a implementação da Microsoft do WS-Man.]
O serviço Microsoft SNMP chama a função SnmpExtensionMonitor para fornecer ao agente de extensão SNMP uma exibição para os contadores e parâmetros internos do serviço. Essa função é um elemento da API do Agente de Extensão SNMP.
A função SnmpExtensionMonitor é opcional. Os agentes de extensão devem implementar a função se estiverem interessados em uma exibição dos objetos de gerenciamento interno do serviço SNMP, conforme definido no RFC 1213, "Base de informações de gerenciamento para gerenciamento de rede de internets baseadas em TCP/IP: MIB-II".
Sintaxe
BOOL SNMP_FUNC_TYPE SnmpExtensionMonitor(
[in] LPVOID pAgentMgmtData
);
Parâmetros
[in] pAgentMgmtData
Ponteiro para uma matriz de objetos AsnAny (estruturas). O número de objetos e o tipo e a descrição de cada objeto estão de acordo com o RFC 1213. Para obter mais informações, consulte a seção Comentários a seguir.
Retornar valor
A menos que ocorra um erro inesperado enquanto o agente de extensão SNMP estiver processando o valor do parâmetro pAgentMgmtData , o agente de extensão deverá retornar TRUE. Se o agente de extensão retornar FALSE, o serviço SNMP não carregará o agente de extensão e o serviço deixará de direcionar solicitações SNMP para o agente de extensão.
Comentários
Se o agente de extensão exportar a função SnmpExtensionMonitor , o serviço SNMP chamará a função durante a inicialização do agente de extensão, imediatamente após o serviço chamar as funções SnmpExtensionInit e SnmpExtensionInitEx .
O serviço SNMP atualiza dinamicamente os contadores SNMP (por exemplo, os contadores snmpInPkts e snmpOutNoSuchNames) na matriz apontada pelo parâmetro pAgentMgmtData . Para poder ler esses valores enquanto o serviço SNMP está em execução, o agente de extensão deve armazenar o ponteiro para pAgentMgmtData.
Observe que um agente de extensão SNMP não deve atualizar a memória apontada pelo parâmetro pAgentMgmtData . Isso ocorre porque os valores dos contadores internos do serviço SNMP não seriam mais válidos e o comportamento do serviço SNMP poderia se tornar imprevisível. Desde que o agente de extensão não o altere, a memória apontada por pAgentMgmtData é válida enquanto o serviço SNMP está em execução.
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] |
| Plataforma de Destino | Windows |
| Cabeçalho | snmp.h |