Funzione SnmpStartupEx (winsnmp.h)
[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 SnmpStartupEx notifica all'implementazione di Microsoft WinSNMP che l'applicazione WinSNMP richiede i servizi dell'implementazione. La funzione WinSNMP SnmpStartupEx consente all'implementazione di inizializzare e tornare all'applicazione la versione dell'INTERFACCIA di programmazione dell'applicazione Windows SNMP (API WinSNMP), il livello di comunicazioni SNMP supportate dall'implementazione e le modalità predefinite di traduzione e ritrasmissione dell'implementazione.
Questa funzione deve essere usata invece di SnmpStartup se è installato Windows Server 2003 con Service Pack 1 (SP1) o versioni successive. SnmpStartupEx abilita il supporto per più moduli software indipendenti che usano WinSNMP all'interno della stessa applicazione.
Sintassi
SNMPAPI_STATUS SNMPAPI_CALL SnmpStartupEx(
[out] smiLPUINT32 nMajorVersion,
[out] smiLPUINT32 nMinorVersion,
[out] smiLPUINT32 nLevel,
[out] smiLPUINT32 nTranslateMode,
[out] smiLPUINT32 nRetransmitMode
);
Parametri
[out] nMajorVersion
Puntatore a una variabile integer long 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 integer long 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 integer long 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 integer long senza segno per ricevere la modalità di traduzione predefinita in effetti per l'implementazione. La modalità di traduzione si applica al modo in cui l'implementazione interpreta il parametro dell'entità , che l'applicazione WinSNMP passa alla funzione SnmpStrToEntity . La modalità di traduzione si applica anche al parametro stringa passato dall'applicazione WinSNMP alla funzione SnmpStrToContext . Questo parametro può avere uno dei valori seguenti.
Per altre informazioni, vedere Impostazione della modalità di traduzione di entità e contesto.
[out] nRetransmitMode
Puntatore a una variabile integer long senza segno per ricevere la modalità di ritrasmissione predefinita in effetti per l'implementazione. Questo parametro può avere uno dei valori seguenti.
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 è 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" più avanti in questo documento.
| Codice restituito | Descrizione |
|---|---|
|
Si è verificato un errore di allocazione delle risorse durante l'avvio. |
|
La funzione SnmpStartupEx non ha inizializzato correttamente. |
|
Errore durante l'allocazione della memoria. |
|
Si è verificato un errore sconosciuto o non definito. |
Commenti
Un'applicazione WinSNMP deve chiamare la funzione SnmpStartupEx almeno una volta prima di chiamare qualsiasi altra funzione WinSNMP. Se un'applicazione WinSNMP chiama un'altra funzione WinSNMP prima che venga chiamata correttamente SnmpStartupEx, l'implementazione restituisce l'errore SNMPAPI_NOT_INITIALIZED.
L'applicazione WinSNMP può chiamare SnmpGetLastError per informazioni sugli errori o riprovare SnmpStartupEx se una chiamata alla funzione SnmpStartupEx ha esito negativo. Quando SnmpStartupEx restituisce SNMPAPI_FAILURE e una chiamata successiva a SnmpGetLastError restituisce SNMP_ALLOC_ERROR, l'applicazione WinSNMP può scegliere di attendere. Può riprovare la chiamata a SnmpStartupEx quando l'implementazione ha risorse gratuite adeguate.
Un'applicazione WinSNMP deve chiamare SnmpCleanupEx per ogni chiamata riuscita a SnmpStartupEx. L'implementazione winSNMP esegue la pulizia finale in cui non sono presenti chiamate con esito positivo a SnmpStartup o SnmpStartupEx.
Per altre informazioni, vedere Livelli di supporto SNMP e Informazioni sulle versioni SNMP.
Requisiti
| 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 |