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