Funzione SnmpContextToStr (winsnmp.h)

Articolo
03/15/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 SnmpContextToStr WinSNMP restituisce una stringa che identifica un contesto SNMP, ovvero un set di risorse oggetto gestito. La funzione restituisce la stringa in una struttura smiOCTETS .

Sintassi

SNMPAPI_STATUS SNMPAPI_CALL SnmpContextToStr(
  [in]  HSNMP_CONTEXT context,
  [out] smiLPOCTETS   string
);

Parametri

[in] context

Gestire il contesto SNMP di interesse.

[out] string

Puntatore a una struttura smiOCTETS per ricevere la stringa che identifica il contesto di interesse. La stringa può avere un byte di terminazione Null.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene SNMPAPI_SUCCESS.

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_CONTEXT_INVALID	Il parametro di contesto non è valido.
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 tipo di stringa di output SnmpContextToStr restituisce. Per altre informazioni, vedere Impostazione della modalità di conversione dell'entità e del contesto.

L'applicazione WinSNMP deve fornire l'indirizzo di una struttura smiOCTETS valida per il parametro stringa . Se la funzione SnmpContextToStr viene completata correttamente, l'implementazione di Microsoft WinSNMP inizializza i membri len e ptr della struttura. L'applicazione WinSNMP deve chiamare la funzione SnmpFreeDescriptor per consentire all'implementazione di liberare le risorse per questi membri.

Quando la modalità di conversione dell'entità e del contesto è SNMPAPI_TRANSLATED e la voce esiste nel database dell'implementazione, l'implementazione restituisce il nome descrittivo associato del contesto. Se non esiste una voce per il nome del contesto, SnmpContextToStr restituisce la stringa della community SNMP.

Quando la modalità di conversione dell'entità e del contesto è SNMPAPI_UNTRANSLATED_V1 o SNMPAPI_UNTRANSLATED_V2, l'implementazione restituisce anche la stringa della community 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

Vedi anche

SnmpFreeDescriptor

Funzioni WinSNMP

Panoramica dell'API WinSNMP

smiOCTETS