Compartilhar via

Função SnmpGetRetransmitMode (winsnmp.h)

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

A função WinSNMP SnmpGetRetransmitMode retorna a configuração atual do modo de retransmissão para um aplicativo WinSNMP. A implementação do Microsoft WinSNMP usa o modo de retransmissão para controlar tempos limite de transmissão e tentativas de retransmissão em chamadas para a função SnmpSendMsg .

Sintaxe

SNMPAPI_STATUS SNMPAPI_CALL SnmpGetRetransmitMode(
  [out] smiLPUINT32 nRetransmitMode
);

Parâmetros

[out] nRetransmitMode

Ponteiro para uma variável de inteiro longo sem sinal para receber o modo de retransmissão atual em vigor para a implementação. Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
SNMPAPI_ON
 A implementação está executando a política de retransmissão do aplicativo WinSNMP.
SNMPAPI_OFF
 A implementação não está executando 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. Se SnmpGetRetransmitMode falhar, o valor do parâmetro nRetransmitMode não terá significado para o aplicativo. 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_OTHER_ERROR
 Ocorreu um erro desconhecido ou indefinido.

Comentários

Normalmente, um aplicativo WinSNMP, em vez de um aplicativo de agente, chama a função SnmpGetRetransmitMode . 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

SnmpSetRetransmitMode

SnmpStartup

Funções WinSNMP

Visão geral da API do WinSNMP