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
- Funções da API de Gerenciamento 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 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. |