SNMPAPI_CALLBACK funzione di callback (winsnmp.h)

Articolo
03/13/2024

[SNMP è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. Usare invece Gestione remota Windows, ovvero l'implementazione Microsoft di WS-Man.

L'implementazione di Microsoft WinSNMP chiama la funzione SNMPAPI_CALLBACK per notificare a una sessione WinSNMP che è disponibile un messaggio SNMP o un evento asincrono.

SNMPAPI_CALLBACK è un segnaposto per un nome di funzione di callback definito dall'applicazione o dalla libreria.

Sintassi

SNMPAPI_CALLBACK SnmpapiCallback;

SNMPAPI_STATUS SnmpapiCallback(
  [in] HSNMP_SESSION hSession,
  [in] HWND hWnd,
  [in] UINT wMsg,
  [in] WPARAM wParam,
  [in] LPARAM lParam,
  [in] LPVOID lpClientData
)
{...}

Parametri

[in] hSession

Gestire la sessione WinSNMP.

[in] hWnd

Gestire in una finestra dell'applicazione WinSNMP per notificare quando viene completata una richiesta asincrona o quando si verifica una notifica trap. Questo parametro non ha significato per la sessione WinSNMP, ma l'implementazione passa sempre il valore alla funzione di callback.

[in] wMsg

Specifica un intero senza segno che identifica il messaggio di notifica da inviare alla finestra dell'applicazione WinSNMP. Questo parametro non ha significato per la sessione WinSNMP, ma l'implementazione passa sempre il valore alla funzione di callback.

[in] wParam

Specifica un valore a 32 bit definito dall'applicazione che identifica il tipo di notifica. Se questo parametro è uguale a zero, è disponibile un messaggio SNMP per la sessione. L'applicazione deve chiamare la funzione SnmpRecvMsg per recuperare il messaggio. Se questo parametro non è uguale a zero, indica una notifica degli eventi asincrona per la sessione. Per altre informazioni, vedere la sezione Osservazioni seguente.

[in] lParam

Specifica un valore a 32 bit definito dall'applicazione che specifica l'identificatore della richiesta dell'PDU in fase di elaborazione.

[in] lpClientData

Se il parametro lpClientData non era NULL nella chiamata alla funzione SnmpCreateSession per questa sessione, questo parametro è un puntatore ai dati definiti dall'applicazione.

Valore restituito

La funzione deve restituire SNMPAPI_SUCCESS per continuare l'esecuzione dell'applicazione. Se la funzione restituisce qualsiasi altro valore, l'implementazione risponde come se l'applicazione chiami la funzione SnmpClose per la sessione indicata.

Commenti

Quando l'implementazione esegue i criteri di ritrasmissione per l'applicazione WinSNMP e si verifica un timeout di trasmissione, l'implementazione informa la sessione dell'errore. In questa situazione il valore del parametro wParam sarà SNMPAPI_TL_TIMEOUT. Per un elenco di altri errori del livello di trasporto, vedere le pagine di riferimento per le funzioni SnmpRegister, SnmpSendMsg e SnmpRecvMsg .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winsnmp.h

Vedi anche

SnmpClose

SnmpCreateSession

Funzioni WinSNMP

Panoramica dell'API WinSNMP

Condividi tramite