Compartilhar via


Função SnmpSetRetry (winsnmp.h)

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

A função WinSNMP SnmpSetRetry permite que um aplicativo WinSNMP altere o valor de contagem de repetições para a retransmissão de solicitações de mensagem SNMP. A contagem de repetições se aplica a chamadas que um aplicativo WinSNMP faz à função SnmpSendMsg para uma entidade de gerenciamento especificada. A implementação do Microsoft WinSNMP armazena o valor em um banco de dados.

Sintaxe

SNMPAPI_STATUS SNMPAPI_CALL SnmpSetRetry(
  [in] HSNMP_ENTITY hEntity,
  [in] smiUINT32    nPolicyRetry
);

Parâmetros

[in] hEntity

Manipule para a entidade de gerenciamento de destino de interesse.

[in] nPolicyRetry

Especifica um novo valor para a contagem de repetições para a entidade de gerenciamento. Esse valor substitui o valor armazenado atualmente no banco de dados da implementação.

Se esse parâmetro for igual a zero e o modo de retransmissão atual for igual a SNMPAPI_ON, a implementação selecionará um valor para a contagem de repetições. A implementação usa esse valor quando executa a política de retransmissão do aplicativo WinSNMP.

Retornar valor

Se a função for bem-sucedida, o valor retornado será SNMPAPI_SUCCESS.

Se a função falhar, o valor retornado será SNMPAPI_FAILURE. Para obter informações de erro estendidas, chame SnmpGetLastError especificando um valor NULL em seu parâmetro de sessão . A função SnmpGetLastError pode retornar um dos erros a seguir.

Código de retorno Descrição
SNMPAPI_NOT_INITIALIZED
A função SnmpStartup não foi concluída com êxito.
SNMPAPI_ALLOC_ERROR
Ocorreu um erro durante a alocação de memória.
SNMPAPI_ENTITY_INVALID
O parâmetro hEntity é inválido.
SNMPAPI_OTHER_ERROR
Ocorreu um erro desconhecido ou indefinido.

Comentários

Normalmente, um aplicativo gerenciador WinSNMP, em vez de um aplicativo de agente, chama a função SnmpSetRetry .

Para obter informações adicionais, consulte Sobre retransmissão e Gerenciamento da política de retransmissão.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winsnmp.h
Biblioteca Wsnmp32.lib
DLL Wsnmp32.dll

Confira também

SnmpGetRetransmitMode

SnmpGetRetry

SnmpSetRetransmitMode

Funções WinSNMP

Visão geral da API do WinSNMP