Funções SNMP
[SNMP está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Pode ser alterado ou não estar disponí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 da API do Agente de Extensão SNMP
- Funções da API de gerenciamento SNMP
- Funções da API do utilitário SNMP
Funções da 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 do 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 do protocolo SNMP) de entrada.
| Função da API do agente de extensão SNMP | Descrição |
|---|---|
| SnmpExtensionClose | Solicita que o agente de extensão SNMP desaaloque recursos e encerre operações. |
| SnmpExtensionInit | Inicializa a DLL do agente de extensão SNMP. |
| SnmpExtensionInitEx | Identifica quaisquer subárvores adicionais da base de informações de gerenciamento (MIB) suportadas pelo 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 das 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 traps 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 SNMP manager de terceiros e a biblioteca de vínculo dinâmico (DLL) da função de gerenciamento Mgmtapi.dll. A DLL funciona em conjunto com o serviço de trap SNMP (Snmptrap.exe) e pode interagir com um ou mais aplicativos de gerenciador SNMP de terceiros. A tabela a seguir lista as funções de gerenciamento que os aplicativos de gerenciamento de terceiros usam para executar operações do gerenciador SNMP.
| Função da 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 intercetação pendentes que o chamador não recebeu se a receção de intercetação estiver habilitada. |
| SnmpMgrGetTrapEx | Retorna dados de intercetação pendentes que o chamador não recebeu se a receção de intercetação 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ção e estruturas de dados necessários para estabelecer 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 interna de identificador de objeto. |
| SnmpMgrTrapListen | Registra a capacidade de um aplicativo gerenciador SNMP para receber traps SNMP do Serviço de Trap SNMP. |
Funções da API do utilitário SNMP
As funções do utilitário SNMP fornecem recursos que são ú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 API do utilitário SNMP | Descrição |
|---|---|
| SnmpSvcGetUptime | Recupera o tempo, em centisegundos, durante o qual o serviço SNMP foi executado. |
| SnmpSvcSetLogLevel | Ajusta o nível de detalhe da saída de depuração do serviço SNMP e dos agentes de extensão SNMP. |
| SnmpSvcSetLogType | Ajusta o destino para a saída de depuração do serviço SNMP e dos agentes de extensão SNMP. |
| SnmpUtilAsnAnyCpy | Copia uma fonte estrutura AsnAny para uma estrutura de de destino AsnAny. |
| SnmpUtilAsnAnyFree | Libera a memória que foi alocada para um especificado AsnAny estrutura. |
| 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 identificador de objeto (OID) em uma cadeia de caracteres terminada em nulo. |
| SnmpUtilMemAlloc | Aloca memória dinâmica da pilha de processo. |
| SnmpUtilMemFree | Libera o objeto de memória especificado. |
| SnmpUtilMemReAlloc | Altera o tamanho do objeto de memória especificado. |
| SnmpUtilOctetsCmp | Compara duas cordas de octeto. |
| SnmpUtilOctetsCpy | Copia uma origem estrutura de AsnOctetString para um destino estrutura AsnOctetString. |
| SnmpUtilOctetsFree | Libera a memória que foi 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 subidentificadores. |
| SnmpUtilOidAppend | Acrescenta um identificador de objeto de origem, contido em uma estrutura deAsnObjectIdentifier, a um identificador de objeto de destino. |
| SnmpUtilOidCmp | Compara dois identificadores de objeto contidos em estruturas de AsnObjectIdentifier. |
| SnmpUtilOidCpy | Copia uma origem estrutura AsnObjectIdentifier para um destino estrutura AsnObjectIdentifier. |
| SnmpUtilOidFree | Libera a memória que foi alocada para o identificador de objeto especificado. |
| SnmpUtilOidNCmp | Compara dois identificadores de objeto contidos em estruturas de AsnObjectIdentifier com o número especificado de subidentificadores. |
| SnmpUtilOidToA | Converte um identificador de objeto (OID) em uma cadeia de caracteres terminada em nulo. |
| SnmpUtilPrintAsnAny | Imprime um valor contido em uma estrutura deAsnAny para fins de depuração e desenvolvimento. |
| SnmpUtilPrintOid | Formata o identificador de objeto especificado (OID) e imprime o resultado no dispositivo de saída padrão. |
| SnmpUtilVarBindCpy | Copia uma origem estrutura SnmpVarBind para um destino estrutura SnmpVarBind. |
| SnmpUtilVarBindListCpy | Copia uma fonte estrutura de SnmpVarBindList para um destino estrutura de SnmpVarBindList. |
| SnmpUtilVarBindFree | Libera a memória que foi alocada para o especificado SnmpVarBind estrutura. |
| SnmpUtilVarBindListFree | Libera a memória que foi alocada para o especificado SnmpVarBindList estrutura. |