Funzione SnmpStrToContext (winsnmp.h)

Articolo
08/27/2023

[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 SnmpStrToContext WinSNMP restituisce un handle alle informazioni sul contesto SNMP specifiche dell'implementazione di Microsoft WinSNMP. L'handle è un valore valido che un'applicazione WinSNMP può usare come parametro di contesto in una chiamata alle funzioni SnmpSendMsg e SnmpRegister .

Sintassi

HSNMP_CONTEXT SNMPAPI_CALL SnmpStrToContext(
  [in] HSNMP_SESSION session,
  [in] smiLPCOCTETS  string
);

Parametri

[in] session

Gestire la sessione WinSNMP.

[in] string

Puntatore a una struttura smiOCTETS che contiene una stringa da interpretare. La stringa può identificare una raccolta di oggetti gestiti oppure può essere una stringa della community.

L'impostazione corrente della modalità di conversione dell'entità e del contesto determina il modo in cui SnmpStrToContext interpreta la struttura della stringa di input, come illustrato nella tabella seguente.

Modalità di conversione di entità/contesto	Significato
SNMPAPI_TRANSLATED	L'implementazione interpreta il parametro stringa come nome descrittivo per una raccolta di oggetti gestiti. L'implementazione converte il nome nei componenti SNMPv1 o SNMPv2C usando il database dell'implementazione.
SNMPAPI_UNTRANSLATED_V1	L'implementazione interpreta il parametro stringa come stringa SNMP letterale.
SNMPAPI_UNTRANSLATED_V2	L'implementazione interpreta il parametro stringa come stringa SNMP letterale.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un handle per il contesto di interesse.

Se la funzione ha esito negativo, il valore restituito viene SNMPAPI_FAILURE. Per ottenere informazioni estese sull'errore, chiamare SnmpGetLastError. La funzione SnmpGetLastError può restituire uno degli errori seguenti.

Codice restituito	Descrizione
SNMPAPI_NOT_INITIALIZED	La funzione SnmpStartup non è stata completata correttamente.
SNMPAPI_ALLOC_ERROR	Errore durante l'allocazione della memoria.
SNMPAPI_SESSION_INVALID	Il parametro di sessione non è valido.
SNMPAPI_CONTEXT_INVALID	Il formato del parametro stringa non è valido. Ad esempio, il membro len o il membro ptr della struttura smiOCTETS a cui punta il parametro stringa è NULL.
SNMPAPI_CONTEXT_UNKNOWN	Il valore a cui si fa riferimento nel parametro stringa non esiste.
SNMPAPI_OTHER_ERROR	Si è verificato un errore sconosciuto o non definito.

Commenti

L'applicazione WinSNMP deve chiamare la funzione SnmpFreeContext per rilasciare l'handle di contesto allocato dalla funzione SnmpStrToContext . Per altre informazioni sul rilascio delle risorse, vedere Concetti di Gestione dati WinSNMP.

L'applicazione WinSNMP deve liberare la memoria associata al membro ptr della struttura smiOCTETS a cui punta il parametro stringa . Ciò è dovuto al fatto che l'applicazione definisce e alloca le risorse. Ad esempio, se l'applicazione ha allocato risorse con una chiamata alla funzione GlobalAlloc , deve usare la funzione GlobalFree per deallocare le risorse. Per altre informazioni, vedere Freeing WinSNMP Descriptors .For additional information, see Freeing WinSNMP Descriptors.

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