Funzione SnmpMgrOpen (mgmtapi.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 SnmpMgrOpen inizializza i socket di comunicazione e le strutture di dati, consentendo le comunicazioni con l'agente SNMP specificato. Questa funzione è un elemento dell'API di gestione SNMP.

Sintassi

LPSNMP_MGR_SESSION SNMP_FUNC_TYPE SnmpMgrOpen(
  [in] LPSTR lpAgentAddress,
  [in] LPSTR lpAgentCommunity,
  [in] INT   nTimeOut,
  [in] INT   nRetries
);

Parametri

[in] lpAgentAddress

Puntatore a una stringa con terminazione null che specifica un nome host o un indirizzo IP. Il nome host deve essere risolto in un indirizzo IP, un indirizzo IPX (nella notazione 8.12) o in un indirizzo Ethernet. Vedere la sezione Osservazioni per i moduli accettabili per i nomi host e gli indirizzi IP.

[in] lpAgentCommunity

Puntatore a una stringa con terminazione null che specifica il nome della community SNMP da usare durante la comunicazione con l'agente identificato dal parametro lpAgentAddress .

[in] nTimeOut

Specifica il timeout delle comunicazioni in millisecondi.

[in] nRetries

Specifica il conteggio dei tentativi di comunicazione. Il timeout specificato nel parametro nTimeOut viene raddoppiato ogni volta che viene trasmesso un tentativo di ripetizione.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un puntatore a una struttura LPSNMP_MGR_SESSION . Questa struttura viene usata internamente e il programmatore non deve modificarlo. Per ulteriori informazioni, vedere la sezione Osservazioni successiva.

Se la funzione ha esito negativo, il valore restituito è NULL. Per informazioni dettagliate sull'errore, chiamare GetLastError. GetLastError può restituire il codice di errore SNMP_MEM_ALLOC_ERROR, che indica un errore di allocazione della memoria.

Questa funzione può anche restituire codici di errore di Windows Sockets.

Commenti

Se possibile, usare un nome host per identificare l'agente SNMP nel parametro lpAgentAddress . I nomi host possono essere forniti solo se viene caricato TCP/IP e i nomi sono nomi host TCP/IP. I nomi NetBIOS non possono essere forniti per gli host IPX.

Il nome e l'indirizzo della destinazione SNMP o la stringa a cui punta il parametro lpAgentAddress devono essere conformi a uno dei moduli seguenti.

Nome/indirizzo	Modulo (esempio)
Nome host	merlin o merlin.microsoft.com
Indirizzo IPv4	157.57.8.160
Indirizzo IPv6	3ffe:8311:ffff::b3ff:fe88:c33
Indirizzo MAC	00aa0bbccdd
Indirizzo IPX	00006112.00aa00bbccdd

Le applicazioni non devono usare il puntatore LPSNMP_MGR_SESSION restituito da questa funzione per chiamare la funzione SnmpMgrRequest nel contesto di un thread diverso.

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

SnmpMgrRequest

Condividi tramite