Funzione SnmpMgrCtl (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 SnmpMgrCtl imposta un parametro operativo associato a una sessione SNMP. Questa funzione è un elemento dell'API di gestione SNMP.

Sintassi

BOOL SNMP_FUNC_TYPE SnmpMgrCtl(
  [in]  LPSNMP_MGR_SESSION session,
  [in]  DWORD              dwCtlCode,
  [in]  LPVOID             lpvInBuffer,
  [in]  DWORD              cbInBuffer,
  [out] LPVOID             lpvOUTBuffer,
  [out] DWORD              cbOUTBuffer,
  [out] LPDWORD            lpcbBytesReturned
);

Parametri

[in] session

Puntatore a una struttura interna che specifica la sessione a cui si applica il codice del controllo.

[in] dwCtlCode

Specifica un valore (un codice di controllo) che identifica l'operazione da eseguire.

Attualmente, MGMCTL_SETAGENTPORT è l'unico codice di controllo supportato. L'impostazione di questo codice consente a un'applicazione di gestione SNMP di inviare richieste a un agente remoto "in ascolto" per le richieste di gestione SNMP su una porta arbitraria. Per altre informazioni, vedere lpvInBuffer e le descrizioni dei parametri cbInBuffer .

[in] lpvInBuffer

Puntatore al buffer contenente i parametri di input necessari per l'operazione.

Quando si specifica il codice di controllo MGMCTL_SETAGENTPORT, questo parametro deve puntare a un numero intero senza segno che specifica il numero di porta in cui l'agente remoto sarà "in ascolto" per le richieste di gestione SNMP. Il numero di porta deve essere in ordine di byte host.

[in] cbInBuffer

Specifica le dimensioni, in byte, del buffer a cui punta il parametro lpvInBuffer .

Quando si specifica il codice di controllo MGMCTL_SETAGENTPORT, questo parametro è uguale a sizeof(UINT).

[out] lpvOUTBuffer

Puntatore al buffer che riceve i dati di output dell'operazione.

[out] cbOUTBuffer

Specifica le dimensioni, in byte, del buffer a cui punta il parametro lpvOutBuffer .

[out] lpcbBytesReturned

Puntatore a una variabile che riceve le dimensioni effettive, in byte, dei dati archiviati nel buffer a cui punta il parametro lpvOutBuffer .

Valore restituito

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

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError. GetLastError può anche restituire uno dei codici di errore seguenti.

Codice restituito	Descrizione
SNMP_MGMTAPI_INVALID_CTL	Il parametro dwCtlCode non specifica un codice di controllo valido.
SNMP_MGMTAPI_INVALID_SESSION	Il parametro di sessione non specifica una sessione SNMP valida.
SNMP_MGMTAPI_INVALID_BUFFER	Uno o più parametri lpvInBuffer, lpvOutBuffer o lpcbBytesRequired non sono validi oppure il parametro cbInBuffer o cbOutBuffer è troppo piccolo.

Requisiti


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)

SnmpMgrOpen

Condividi tramite