Condividi tramite


Funzione SnmpStrToContext (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 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'impostazione corrente della modalità di conversione dell'entità e del contesto determina il modo in cui SnmpStrToContext interpreta la struttura della stringa di input. Per altre informazioni, vedere Impostazione della modalità di conversione dell'entità e del contesto.

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

Vedi anche

SnmpFreeContext

SnmpFreeDescriptor

SnmpRegister

SnmpSendMsg

Funzioni WinSNMP

Panoramica dell'API WinSNMP

smiOCTETS