Funzione SnmpStrToEntity (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 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.
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 |
---|---|
|
La funzione SnmpStartup non è stata completata correttamente. |
|
Errore durante l'allocazione della memoria. |
|
Il parametro di sessione non è valido. |
|
La stringa di entità non è valida. |
|
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 |