Funzione SnmpMgrRequest (mgmtapi.h)

Articolo
08/24/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 SnmpMgrRequest richiede che l'operazione specificata venga eseguita con l'agente specificato. Questa funzione è un elemento dell'API di gestione SNMP.

Sintassi

SNMPAPI SNMP_FUNC_TYPE SnmpMgrRequest(
  [in]      LPSNMP_MGR_SESSION session,
  [in]      BYTE               requestType,
  [in, out] RFC1157VarBindList *variableBindings,
  [out]     AsnInteger         *errorStatus,
  [out]     AsnInteger         *errorIndex
);

Parametri

[in] session

Puntatore a una struttura interna che specifica la sessione che eseguirà la richiesta.

Le applicazioni non devono specificare il puntatore LPSNMP_MGR_SESSION restituito da questa funzione in un thread diverso. È possibile specificare un puntatore restituito da SnmpMgrOpen, ma solo se le chiamate a SnmpMgrOpen e SnmpMgrRequest hanno origine nel contesto dello stesso thread.

[in] requestType

Specifica il tipo di richiesta SNMP. Questo parametro può essere uno dei valori seguenti definiti da SNMPv1.

Valore	Significato
SNMP_PDU_GET	Recuperare il valore o i valori delle variabili specificate.
SNMP_PDU_GETNEXT	Recuperare il valore o i valori del successore lessicografico della variabile specificata.
SNMP_PDU_SET	Scrivere un valore all'interno di una variabile specifica.

Si noti che i tipi di richiesta PDU sono stati rinominati. Per altre informazioni, vedere Tipi di variabili SNMP e tipi PDU di richiesta.

[in, out] variableBindings

Puntatore all'elenco di associazioni di variabili.

Nota La matrice SnmpVarBind a cui punta la struttura SnmpVarBindList deve essere allocata usando la funzione SnmpUtilMemAlloc .

[out] errorStatus

Puntatore a una variabile in cui verrà restituito il risultato dello stato di errore. Questo parametro può essere uno dei valori seguenti definiti da SNMPv1.

Valore	Significato
SNMP_ERRORSTATUS_NOERROR	L'agente segnala che non si sono verificati errori durante la trasmissione.
SNMP_ERRORSTATUS_TOOBIG	L'agente non è riuscito a inserire i risultati dell'operazione richiesta in un singolo messaggio SNMP.
SNMP_ERRORSTATUS_NOSUCHNAME	L'operazione richiesta ha identificato una variabile sconosciuta.
SNMP_ERRORSTATUS_BADVALUE	L'operazione richiesta ha tentato di modificare una variabile, ma ha specificato un errore di sintassi o valore.
SNMP_ERRORSTATUS_READONLY	L'operazione richiesta ha tentato di modificare una variabile che non è stata autorizzata a modificare in base al profilo della community della variabile.
SNMP_ERRORSTATUS_GENERR	Si è verificato un errore diverso da uno di quelli elencati qui durante l'operazione richiesta.

[out] errorIndex

Puntatore a una variabile in cui verrà restituito il risultato dell'indice di errore.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è NULL. Per ottenere informazioni sull'errore estese, chiamare GetLastError, che può restituire uno dei codici di errore seguenti.

Codice restituito	Descrizione
SNMP_MGMTAPI_TIMEOUT	Timeout della richiesta.
SNMP_MGMTAPI_SELECT_FDERRORS	Descrittori di file di errore imprevisti indicati dalla funzione di selezione di Windows Sockets.

Commenti

I tentativi e i timeout vengono forniti alla funzione SnmpMgrOpen . Ogni variabile nell'elenco di associazioni di variabili deve essere inizializzata per digitare ASN_NULL per le richieste Get e Get Next.

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	mgmtapi.h
Libreria	Mgmtapi.lib
DLL	Mgmtapi.dll

Vedi anche

Funzioni SNMP

Panoramica del protocollo Simple Network Management Protocol (SNMP)

SnmpMgrClose

SnmpMgrOpen

Condividi tramite