Função SnmpGetLastError (winsnmp.h)

Artigo
03/04/2024

[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 SnmpGetLastError retorna o valor do código de último erro do aplicativo de chamada. O valor indica o motivo pelo qual a última chamada de função executada pelo aplicativo WinSNMP falhou.

Sintaxe

SNMPAPI_STATUS SNMPAPI_CALL SnmpGetLastError(
  [in] HSNMP_SESSION session
);

Parâmetros

[in] session

Manipule para a sessão WinSNMP. Esse parâmetro também pode ser NULL.

Em determinados casos, quando uma chamada de função falha, você pode passar um valor de sessãoNULL para a função SnmpGetLastError para recuperar o valor do código de último erro. Isso é verdadeiro para chamadas de função que não envolvem um parâmetro de sessão e casos em que o valor do parâmetro de sessão é inválido. Esses casos são observados na seção Valores retornados na página de referência da função.

Um aplicativo de thread único pode passar um valor de sessãoNULL para SnmpGetLastError para recuperar informações de último erro para todo o aplicativo.

Para obter mais informações, consulte as seções Comentários e Valores retornados a seguir.

Retornar valor

Se o parâmetro de sessão for um identificador de sessão WinSNMP válido, a função SnmpGetLastError retornará o último erro WinSNMP que ocorreu para a sessão indicada.

Se o parâmetro de sessão for NULL , por exemplo, se a função SnmpStartup falhar, SnmpGetLastError retornará o último erro WinSNMP que ocorreu.

Comentários

Um aplicativo WinSNMP deve chamar SnmpGetLastError imediatamente após uma falha de uma função, para recuperar o código do último erro. Se outra função falhar, ela substituirá o código de último erro definido pela função com falha mais recente. Para obter mais informações, consulte Códigos de erro WinSNMP.

Embora o parâmetro de sessão acomode ambientes operacionais Windows multithread e de thread único, o potencial ainda existe para o código de último erro de um thread para substituir o código de último erro de outro thread.

Observe que SnmpGetLastError deve ser capaz de retornar o código de último erro para um aplicativo WinSNMP nas seguintes condições:

Depois que a função SnmpStartup falhar
Antes que a função SnmpCreateSession crie sessões WinSNMP para a instância do aplicativo
Depois que a função SnmpClose fecha todas as sessões WinSNMP para a instância do aplicativo
Depois que a função SnmpCleanup desconecta o aplicativo WinSNMP da implementação do Microsoft WinSNMP

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