Compartilhar via


Funções SNMP

[O SNMP está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes. Em vez disso, use de Gerenciamento Remoto do Windows, que é a implementação da Microsoft do WS-Man.]

Este tópico descreve três agrupamentos de funções SNMP e lista as funções incluídas em cada grupo:

  • Funções de API do Agente de Extensão do SNMP
  • Funções de API de Gerenciamento do SNMP
  • Funções de API do Utilitário SNMP

Funções de API do Agente de Extensão SNMP

As funções do agente de extensão SNMP definem a interface entre o serviço SNMP e as DLLs de agente de extensão SNMP de terceiros. A tabela a seguir lista as funções que os aplicativos podem usar para resolver associações variáveis especificadas por PDUs (unidades de dados de protocolo SNMP) de entrada.

Função de API do Agente de Extensão do SNMP Descrição
SnmpExtensionClose Solicita que o agente de extensão SNMP desaloque recursos e encerre as operações.
SnmpExtensionInit Inicializa a DLL do agente de extensão SNMP.
SnmpExtensionInitEx Identifica quaisquer subárvores MIB (base de informações de gerenciamento) adicionais compatíveis com o agente de extensão SNMP.
SnmpExtensionMonitor Fornece ao agente de extensão SNMP informações sobre os contadores internos e parâmetros do serviço.
SnmpExtensionQuery Resolve solicitações SNMP que contêm variáveis em uma ou mais subárvores MIB registradas do agente de extensão SNMP.
SnmpExtensionQueryEx Processa solicitações SNMP que especificam variáveis em uma ou mais subárvores MIB que são registradas por agentes de extensão SNMP.
SnmpExtensionTrap Recupera informações necessárias para que o serviço gere armadilhas para o agente de extensão SNMP.

 

Funções de API de Gerenciamento do SNMP

As funções de gerenciamento SNMP definem a interface entre aplicativos gerenciadores SNMP de terceiros e a DLL (biblioteca de vínculo dinâmico) da função de gerenciamento Mgmtapi.dll. A DLL funciona em conjunto com o serviço de interceptação do SNMP (Snmptrap.exe) e pode interagir com um ou mais aplicativos gerenciador de SNMP de terceiros. A tabela a seguir lista as funções de gerenciamento que os aplicativos de gerente de terceiros usam para executar operações do gerenciador do SNMP.

Função de API de Gerenciamento do SNMP Descrição
SnmpMgrClose Fecha os soquetes de comunicação e as estruturas de dados associadas à sessão especificada.
SnmpMgrCtl Define um parâmetro operacional associado a uma sessão SNMP.
SnmpMgrGetTrap Retorna dados de interceptação pendentes que o chamador não recebeu se a recepção do trap estiver habilitada.
SnmpMgrGetTrapEx Retorna dados de interceptação pendentes que o chamador não recebeu se a recepção do trap estiver habilitada. Também retorna o endereço da fonte de transporte e a armadilha da comunidade associada à armadilha.
SnmpMgrOidToStr Converte uma estrutura de identificador de objeto interno em sua representação de cadeia de caracteres.
SnmpMgrOpen Inicializa soquetes de comunicações e estruturas de dados que são necessárias para estabelecer a comunicação com o agente SNMP.
SnmpMgrRequest Solicita que a operação especificada seja executada pelo agente especificado.
SnmpMgrStrToOid Converte o formato de cadeia de caracteres de um identificador de objeto em sua estrutura de identificador de objeto interno.
SnmpMgrTrapListen Registra a capacidade de um aplicativo gerenciador SNMP receber armadilhas SNMP do Serviço de Interceptação SNMP.

 

Funções de API do Utilitário SNMP

As funções do utilitário SNMP fornecem recursos úteis durante o desenvolvimento de aplicativos SNMP, incluindo a simplificação da manipulação de estruturas de dados SNMP. A tabela a seguir lista as funções do utilitário SNMP.

Função de API do Utilitário SNMP Descrição
SnmpSvcGetUptime Recupera o tempo, em centissegundos, para o qual o serviço SNMP está em execução.
SnmpSvcSetLogLevel Ajusta o nível de detalhes da saída de depuração do serviço SNMP e de agentes de extensão SNMP.
SnmpSvcSetLogType Ajusta o destino da saída de depuração do serviço SNMP e de agentes de extensão SNMP.
SnmpUtilAsnAnyCpy Copia uma estrutura deAsnAny dede origem para uma estrutura de AsnAny de destino.
SnmpUtilAsnAnyFree Libera a memória alocada para uma estrutura deasnAnyespecificada.
SnmpUtilDbgPrint Define o nível de informações de depuração a serem recebidas do serviço SNMP ou de uma chamada para SnmpUtilDbgPrint.
SnmpUtilIdsToA Converte um OID (identificador de objeto) em uma cadeia de caracteres terminada em nulo.
SnmpUtilMemAlloc Aloca memória dinâmica do heap de processo.
SnmpUtilMemFree Libera o objeto de memória especificado.
SnmpUtilMemReAlloc Altera o tamanho do objeto de memória especificado.
SnmpUtilOctetsCmp Compara duas cadeias de caracteres de octeto.
SnmpUtilOctetsCpy Copia uma estrutura deasnOctetStringde origem para um destino estrutura de AsnOctetString.
SnmpUtilOctetsFree Libera a memória alocada para a cadeia de caracteres de octeto especificada.
SnmpUtilOctetsNCmp Executa uma comparação de duas cadeias de caracteres de octeto com o número especificado de subidentifiers.
SnmpUtilOidAppend Acrescenta um identificador de objeto de origem, contido em uma estruturaasnObjectIdentifier, a um identificador de objeto de destino.
SnmpUtilOidCmp Compara dois identificadores de objeto contidos em estruturas de AsnObjectIdentifier.
SnmpUtilOidCpy Copia uma estrutura deAsnObjectIdentifier dede origem para um de destino asnObjectIdentifier.
SnmpUtilOidFree Libera a memória alocada para o identificador de objeto especificado.
SnmpUtilOidNCmp Compara dois identificadores de objeto contidos em estruturas AsnObjectIdentifier com o número especificado de subidentifiers.
SnmpUtilOidToA Converte um OID (identificador de objeto) em uma cadeia de caracteres terminada em nulo.
SnmpUtilPrintAsnAny Imprime um valor contido em uma estrutura deasnAnypara fins de depuração e desenvolvimento.
SnmpUtilPrintOid Formata o OID (identificador de objeto) especificado e imprime o resultado no dispositivo de saída padrão.
SnmpUtilVarBindCpy Copia uma estrutura deSnmpVarBind dede origem para um destino estrutura de SnmpVarBind.
SnmpUtilVarBindListCpy Copia uma estrutura deSnmpVarBindList dede origem para um destino estrutura de SnmpVarBindList.
SnmpUtilVarBindFree Libera a memória alocada para a estrutura deSnmpVarBindespecificada.
SnmpUtilVarBindListFree Libera a memória alocada para a estrutura deSnmpVarBindListespecificada.