Funzione SnmpStrToEntity (winsnmp.h)

Articolo
03/09/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 SnmpStrToEntity WinSNMP restituisce un handle per informazioni su un'entità di gestione SNMP specifica dell'implementazione di Microsoft WinSNMP.

Sintassi

HSNMP_ENTITY SNMPAPI_CALL SnmpStrToEntity(
  [in] HSNMP_SESSION session,
  [in] LPCSTR        string
);

Parametri

[in] session

Gestire la sessione WinSNMP.

[in] string

Puntatore a una stringa con terminazione Null che identifica l'entità di gestione SNMP di interesse. L'impostazione corrente della modalità di conversione dell'entità e del contesto determina il modo in cui SnmpStrToEntity interpreta la stringa di input come indicato di seguito.

Modalità di conversione di entità/contesto	Significato
SNMPAPI_TRANSLATED	L'implementazione interpreta il parametro stringa come nome descrittivo. 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 indirizzo di trasporto SNMP letterale.
SNMPAPI_UNTRANSLATED_V2	L'implementazione interpreta il parametro stringa come indirizzo di trasporto SNMP letterale.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un handle per l'entità di gestione SNMP 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_ENTITY_UNKNOWN	La stringa di entità non è valida.
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 SnmpStrToEntity interpreta la stringa di input che identifica l'entità di gestione di interesse. Per altre informazioni, vedere Supporto per le stringhe di indirizzi IPX in WinSNMP e Impostazione della modalità di conversione dell'entità e del contesto.

L'applicazione WinSNMP deve chiamare la funzione SnmpFreeEntity per rilasciare l'handle di entità allocato dalla funzione SnmpStrToEntity . Per altre informazioni, vedere Concetti di Gestione dati WinSNMP.

La funzione SnmpStrToEntity restituisce un handle di entità valido che un'applicazione WinSNMP può usare come parametro srcEntity o dstEntity in più funzioni WinSNMP. Queste funzioni includono le funzioni SnmpSendMsg, SnmpRecvMsg, SnmpRegister, SnmpEncodeMsg e SnmpDecodeMsg .

L'implementazione restituisce l'entità corrente e la modalità di conversione del contesto nel parametro nTranslateMode della funzione SnmpStartup . Un'applicazione WinSNMP può modificare l'impostazione della modalità di conversione dell'entità e del contesto con una chiamata alla funzione SnmpSetTranslateMode .

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