Compartilhar via


Funções SNMP

[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.]

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 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 resolve associações de variáveis especificadas por PDUs (unidades de dados de protocolo SNMP) de entrada.

Função de API do Agente de Extensão 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 registradas por agentes de extensão SNMP.
Snmpextensiontrap Recupera informações que o serviço requer para gerar interceptações para o agente de extensão SNMP.

 

Funções da API de Gerenciamento 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 SNMP (Snmptrap.exe) e pode interagir com um ou mais aplicativos gerenciador SNMP de terceiros. A tabela a seguir lista as funções de gerenciamento que os aplicativos gerenciador de terceiros usam para executar operações do gerenciador SNMP.

Função de API de Gerenciamento 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 de interceptação estiver habilitada.
SnmpMgrGetTrapEx Retorna dados de interceptação pendentes que o chamador não recebeu se a recepção de interceptação estiver habilitada. Também retorna o endereço da origem do 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ção e estruturas de dados 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 de receber interceptações 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 centisegundos, 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 dos agentes de extensão SNMP.
SnmpSvcSetLogType Ajusta o destino da saída de depuração do serviço SNMP e dos agentes de extensão SNMP.
SnmpUtilAsnAnyCpy Copia uma estrutura AsnAny de origem para uma estrutura AsnAny de destino.
SnmpUtilAsnAnyFree Libera a memória alocada para uma estrutura AsnAny especificada.
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 AsnOctetString de origem para uma estrutura AsnOctetString de destino.
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 estrutura AsnObjectIdentifier , a um identificador de objeto de destino.
SnmpUtilOidCmp Compara dois identificadores de objeto contidos em estruturas AsnObjectIdentifier .
SnmpUtilOidCpy Copia uma estrutura AsnObjectIdentifier de origem para uma estrutura asnObjectIdentifier de destino.
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 AsnAny para 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 SnmpVarBind de origem para uma estrutura SnmpVarBind de destino.
SnmpUtilVarBindListCpy Copia uma estrutura SnmpVarBindList de origem para uma estrutura SnmpVarBindList de destino.
SnmpUtilVarBindFree Libera a memória alocada para a estrutura SnmpVarBind especificada.
SnmpUtilVarBindListFree Libera a memória alocada para a estrutura SnmpVarBindList especificada.