Função SnmpSetRetransmitMode (winsnmp.h)

Artigo
08/27/2023

[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 SnmpSetRetransmitMode permite que um aplicativo WinSNMP defina o modo de retransmissão. A implementação do Microsoft WinSNMP usa o novo modo de retransmissão para controlar tempos limite de transmissão e tentativas de retransmissão em chamadas subsequentes para a função SnmpSendMsg .

Sintaxe

SNMPAPI_STATUS SNMPAPI_CALL SnmpSetRetransmitMode(
  [in] smiUINT32 nRetransmitMode
);

Parâmetros

[in] nRetransmitMode

Especifica um valor para o novo modo de retransmissão. Esse parâmetro deve usar um dos valores a seguir.

Valor	Significado
SNMPAPI_ON	A implementação executa a política de retransmissão do aplicativo WinSNMP.
SNMPAPI_OFF	A implementação não executa a política de retransmissão do aplicativo WinSNMP.

Valor retornado

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_MODE_INVALID	A implementação não dá suporte ao modo de retransmissão solicitado.
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 SnmpSetRetransmitMode .

Se um aplicativo WinSNMP definir o modo de retransmissão como SNMPAPI_OFF, a implementação não iniciará tentativas de retransmissão para novas operações de comunicação SNMP. A nova configuração afeta todas as chamadas subsequentes para a função SnmpSendMsg , até que o aplicativo WinSNMP defina o modo de retransmissão de volta como SNMPAPI_ON.

Chamar a função SnmpCancelMsg é equivalente a chamar a função SnmpSetRetransmitMode para uma mensagem SNMP específica, com o modo de retransmissão igual a SNMPAPI_OFF.

Nota Se a implementação retornar o erro SNMPAPI_MODE_INVALID a uma chamada para SnmpSetRetransmitMode, o aplicativo WinSNMP deverá executar a política de retransmissão.

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

Requisitos


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