Funzione SnmpStartup (winsnmp.h)

Articolo
03/04/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.

La funzione SnmpStartup notifica all'implementazione di Microsoft WinSNMP che l'applicazione WinSNMP richiede i servizi dell'implementazione. La funzione SnmpStartup WinSNMP consente all'implementazione di inizializzare e tornare all'applicazione la versione di Windows SNMP Application Programming Interface (API WinSNMP), il livello di comunicazioni SNMP supportate dall'implementazione e le modalità di conversione e ritrasmissione predefinite dell'implementazione.

Nota Un'applicazione WinSNMP deve chiamare correttamente la funzione SnmpStartup prima di chiamare qualsiasi altra funzione WinSNMP.

Sintassi

SNMPAPI_STATUS SNMPAPI_CALL SnmpStartup(
  [out] smiLPUINT32 nMajorVersion,
  [out] smiLPUINT32 nMinorVersion,
  [out] smiLPUINT32 nLevel,
  [out] smiLPUINT32 nTranslateMode,
  [out] smiLPUINT32 nRetransmitMode
);

Parametri

[out] nMajorVersion

Puntatore a una variabile long integer senza segno per ricevere il numero di versione principale dell'API WinSNMP supportata dall'implementazione. Ad esempio, per indicare che l'implementazione supporta WinSNMP versione 2.0, la funzione restituisce un valore pari a 2.

[out] nMinorVersion

Puntatore a una variabile long integer senza segno per ricevere il numero di versione secondaria dell'API WinSNMP supportata dall'implementazione. Ad esempio, per indicare che l'implementazione supporta WinSNMP versione 2.0, la funzione restituisce un valore pari a 0.

[out] nLevel

Puntatore a una variabile long integer senza segno per ricevere il livello massimo di comunicazioni SNMP supportate dall'implementazione. Al termine della restituzione, questo parametro contiene un valore pari a 2. Per una descrizione del supporto di livello 2, vedere Livelli di supporto SNMP.

[out] nTranslateMode

Puntatore a una variabile long integer senza segno per ricevere la modalità di conversione predefinita in vigore per l'implementazione. La modalità di conversione si applica all'interpretazione dell'implementazione del parametro di entità passato dall'applicazione WinSNMP alla funzione SnmpStrToEntity . La modalità di conversione si applica anche al parametro stringa che l'applicazione WinSNMP passa alla funzione SnmpStrToContext . Questo parametro può avere uno dei valori seguenti.

Valore	Significato
SNMPAPI_TRANSLATED	L'implementazione usa il database per tradurre nomi descrittivi per le entità SNMP e gli oggetti gestiti. L'implementazione li converte nei componenti SNMPv1 o SNMPv2C.
SNMPAPI_UNTRANSLATED_V1	L'implementazione interpreta i parametri di entità SNMP come indirizzi di trasporto SNMP e parametri di contesto come stringhe della community SNMP. Per le entità di destinazione SNMPv2, l'implementazione crea messaggi SNMP in uscita che contengono un valore pari a zero nel campo della versione.
SNMPAPI_UNTRANSLATED_V2	L'implementazione interpreta i parametri di entità SNMP come indirizzi di trasporto SNMP e parametri di contesto come stringhe della community SNMP. Per le entità di destinazione SNMPv2, l'implementazione crea messaggi SNMP in uscita che contengono un valore 1 nel campo della versione.

Per altre informazioni, vedere Impostazione della modalità di conversione dell'entità e del contesto.

[out] nRetransmitMode

Puntatore a una variabile long integer senza segno per ricevere la modalità di ritrasmissione predefinita in vigore per l'implementazione. Questo parametro può avere uno dei valori seguenti.

Valore	Significato
SNMPAPI_OFF	L'implementazione non esegue i criteri di ritrasmissione dell'applicazione WinSNMP.
SNMPAPI_ON	L'implementazione esegue i criteri di ritrasmissione dell'applicazione WinSNMP.

Per altre informazioni, vedere Informazioni sulla ritrasmissione.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è SNMPAPI_SUCCESS e i parametri contengono valori appropriati, come indicato nelle descrizioni dei parametri precedenti.

Se la funzione ha esito negativo, il valore restituito viene SNMPAPI_FAILURE. Per ottenere informazioni sull'errore estese, chiamare SnmpGetLastError specificando un valore NULL nel relativo parametro di sessione . La funzione SnmpGetLastError può restituire uno degli errori seguenti. Per altre informazioni, vedere la sezione Osservazioni riportata di seguito.

Codice restituito	Descrizione
SNMPAPI_NOT_INITIALIZED	La funzione SnmpStartup non è stata completata correttamente.
SNMPAPI_ALLOC_ERROR	Errore durante l'allocazione della memoria.
SNMPAPI_OTHER_ERROR	Si è verificato un errore sconosciuto o non definito.

Commenti

Un'applicazione WinSNMP deve chiamare correttamente la funzione SnmpStartup almeno una volta, prima di chiamare qualsiasi altra funzione WinSNMP. Se un'applicazione WinSNMP chiama un'altra funzione WinSNMP, prima di chiamare correttamente SnmpStartup, l'implementazione restituisce l'errore SNMPAPI_NOT_INITIALIZED.

L'applicazione WinSNMP può chiamare SnmpGetLastError per informazioni sull'errore oppure ripetere SnmpStartup se una chiamata alla funzione SnmpStartup ha esito negativo. Quando SnmpStartup restituisce SNMPAPI_FAILURE e una chiamata successiva a SnmpGetLastError restituisce SNMP_ALLOC_ERROR, l'applicazione WinSNMP può scegliere di attendere. Può ripetere la chiamata a SnmpStartup quando l'implementazione dispone di risorse gratuite adeguate.

Un'applicazione WinSNMP può chiamare SnmpStartup più volte. Ad esempio, potrebbe essere necessario ripetere la chiamata di funzione per i motivi descritti in precedenza. Un'applicazione WinSNMP deve anche chiamare SnmpCleanup almeno una volta, come l'ultima chiamata di funzione WinSNMP prima che termini. Più chiamate SnmpStartup non richiedono più chiamate SnmpCleanup .

Per altre informazioni, vedere Livelli di supporto SNMP e Informazioni sulle versioni SNMP.

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
Libreria	Wsnmp32.lib
DLL	Wsnmp32.dll

Vedi anche

Panoramica dell'API WinSNMP

Condividi tramite