Compartilhar via

Funções WinSNMP

  • Artigo

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

As funções usadas com WinSNMP se enquadram nos seguintes agrupamentos funcionais. Segue-se uma lista alfabética.

Funções de comunicação WinSNMP

As funções de comunicação WinSNMP fornecem uma interface entre o aplicativo WinSNMP de chamada e a implementação do Microsoft WinSNMP. A implementação lida com a comunicação entre o aplicativo e outras entidades de gerenciamento.

Função Descrição
SnmpCancelMsg Solicita que a implementação do Microsoft WinSNMP cancele tentativas de retransmissão e notificações de tempo limite para uma mensagem de solicitação SNMP.
SnmpCleanup Informa à implementação que um aplicativo está desconectando e não requer mais recursos alocados.
SnmpCleanupEx Executa a limpeza quando não há chamadas bem-sucedidas pendentes para SnmpStartup ou SnmpStartupEx em um aplicativo WinSNMP.
SnmpClose Permite que a implementação desaloque recursos associados a uma sessão e feche mecanismos de comunicação.
SnmpCreateSession Solicita a implementação para abrir uma sessão WinSNMP e alocar recursos e mecanismos de comunicação. Ao desenvolver novos aplicativos WinSNMP, é recomendável chamar a função SnmpCreateSession para abrir uma sessão WinSNMP em vez de chamar a função SnmpOpen .
SnmpListen Registra ou cancela o registro de um aplicativo WinSNMP como um agente SNMP.
SnmpOpen Solicita a implementação para abrir uma sessão WinSNMP e alocar recursos e mecanismos de comunicação. Ao desenvolver novos aplicativos WinSNMP, é recomendável chamar a função SnmpCreateSession para abrir uma sessão WinSNMP em vez de chamar a função SnmpOpen .
SnmpRecvMsg Retorna mensagens SNMP e dados de interceptação pendentes e notificações.
SnmpRegister Informa à implementação que o aplicativo precisa registrar ou cancelar o registro de interceptações e notificações.
SnmpSendMsg Solicita que a implementação transmita uma unidade de dados de protocolo.
SnmpStartup Notifica a implementação para executar procedimentos de inicialização para o aplicativo. Um aplicativo deve chamar a função SnmpStartup com êxito antes de chamar qualquer outra função WinSNMP.
SnmpStartupEx Notifica a implementação do Microsoft WinSNMP de que o aplicativo WinSNMP requer os serviços da implementação. O SnmpStartupEx permite suporte para vários módulos de software independentes que usam WinSNMP no mesmo aplicativo.
SNMPAPI_CALLBACK Notifica uma sessão WinSNMP de que uma mensagem SNMP ou evento assíncrono está disponível. Nota: Essa função de retorno de chamada se aplica somente a sessões abertas como resultado de uma chamada para a função SnmpCreateSession .

Funções de entidade e contexto do WinSNMP

As funções de contexto e entidade WinSNMP permitem que um aplicativo WinSNMP especifique nomes amigáveis para entidades e contextos SNMP. A implementação do Microsoft WinSNMP converte o nome para seus componentes SNMPv1 ou SNMPv2C usando o banco de dados da implementação.

Função Descrição
SnmpContextToStr Retorna uma cadeia de caracteres que identifica um contexto SNMP (um conjunto de recursos de objeto gerenciado).
SnmpEntityToStr Retorna uma cadeia de caracteres que identifica uma entidade de gerenciamento SNMP.
SnmpFreeContext Libera recursos alocados pela função SnmpStrToContext para um contexto SNMP.
SnmpFreeEntity Libera recursos alocados pela função SnmpStrToEntity para uma entidade de gerenciamento SNMP.
SnmpSetPort Altera a porta atribuída a uma entidade de destino SNMP.
SnmpStrToContext Retorna um identificador para informações de contexto SNMP específicas para a implementação.
SnmpStrToEntity Retorna um identificador para informações de entidade de gerenciamento SNMP específicas para a implementação.

Funções de banco de dados WinSNMP

As funções de banco de dados WinSNMP fornecem a um aplicativo WinSNMP acesso às configurações atuais no repositório de informações administrativas da implementação do Microsoft WinSNMP. Essas funções permitem alterar o modo de retransmissão e a entidade e o modo de tradução de contexto. As funções de banco de dados também fornecem ao aplicativo a capacidade de manipular os valores de contagem de tempo limite e repetição.

Função Descrição
SnmpGetRetransmitMode Retorna a configuração atual do modo de retransmissão.
SnmpGetRetry Retorna o valor de contagem de repetições, em unidades, para a retransmissão de solicitações de mensagem SNMP.
SnmpGetTimeout Retorna o valor de tempo limite, em centésimos de segundo, para a transmissão de solicitações de mensagem SNMP.
SnmpGetTranslateMode Retorna a configuração atual da entidade e do modo de tradução de contexto.
SnmpGetVendorInfo Recupera informações que identificam o fornecedor WinSNMP.
SnmpSetRetransmitMode Altera o modo de retransmissão.
SnmpSetRetry Altera o valor da contagem de repetições para a retransmissão de solicitações de mensagem SNMP.
SnmpSetTimeout Altera o valor de tempo limite para a transmissão de solicitações de mensagem SNMP.
SnmpSetTranslateMode Altera a entidade e o modo de tradução de contexto.

Funções PDU do WinSNMP

As funções de PDU WinSNMP permitem que aplicativos WinSNMP extraam e atualizem os elementos de dados (ou campos) de uma PDU. Isso inclui PDUs retornadas por uma chamada para a função SnmpRecvMsg ou a função SnmpDecodeMsg . As funções de PDU também constroem PDUs para uso nas funções SnmpSendMsg e SnmpEncodeMsg .

Função Descrição
SnmpCreatePdu Cria e inicializa uma unidade de dados de protocolo SNMP.
SnmpDuplicatePdu Duplica uma unidade de dados de protocolo SNMP.
SnmpFreePdu Libera recursos associados a uma unidade de dados de protocolo SNMP criada pela função SnmpCreatePdu ou SnmpDuplicatePdu .
SnmpGetPduData Retorna elementos de dados selecionados de uma unidade de dados de protocolo SNMP especificada.
SnmpSetPduData Atualizações elementos de dados selecionados em uma unidade de dados de protocolo SNMP especificada.

Funções do utilitário WinSNMP

As funções do utilitário WinSNMP permitem que um aplicativo WinSNMP gerencie objetos e mensagens SNMP na interface WinSNMP.

Função Descrição
SnmpDecodeMsg Decodifica uma mensagem SNMP codificada ou serializada em seus componentes constituintes.
SnmpEncodeMsg Cria uma mensagem SNMP codificada.
SnmpFreeDescriptor Sinaliza à implementação do Microsoft WinSNMP que ele deve liberar a memória alocada para um descritor específico.
SnmpGetLastError Retorna o valor do último código de erro para a última operação SNMP.
SnmpOidCompare Compara dois identificadores de objeto SNMP.
SnmpOidCopy Copia um identificador de objeto SNMP.
SnmpOidToStr Converte a representação binária interna de um identificador de objeto SNMP em seu formato de cadeia de caracteres numérica pontilhada.
SnmpStrToOid Converte o formato de cadeia de caracteres numérica pontilhada de um identificador de objeto SNMP em sua representação binária interna.

Funções de associação de variável WinSNMP

As funções de associação de variável WinSNMP permitem que aplicativos WinSNMP construam e manipulem listas de associação de variáveis e as incluam em PDUs.

Função Descrição
SnmpCountVbl Enumera as entradas de associação de variável em uma lista de associação de variável especificada.
SnmpCreateVbl Cria uma nova lista de associação de variáveis.
SnmpDeleteVb Remove uma entrada de associação de variável de uma lista de associação de variáveis.
SnmpDuplicateVbl Copia uma lista de associação de variáveis.
SnmpFreeVbl Libera recursos para uma lista de associação de variáveis alocada anteriormente pela função SnmpCreateVbl ou SnmpDuplicateVbl .
SnmpGetVb Recupera informações de uma entrada de associação de variável especificada.
SnmpSetVb Altera as entradas de associação de variável em uma lista de associação de variáveis; acrescenta novas entradas de associação de variável a uma lista de associação de variável existente.

Lista alfabética de funções WinSNMP