Función SnmpMgrOpen (mgmtapi.h)

[SNMP está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. En versiones posteriores podría modificarse o no estar disponible. En su lugar, use la administración remota de Windows, que es la implementación de Microsoft de WS-Man.]

La función SnmpMgrOpen inicializa los sockets de comunicaciones y las estructuras de datos, lo que permite las comunicaciones con el agente SNMP especificado. Esta función es un elemento de la API de administración de SNMP.

Sintaxis

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

Parámetros

[in] lpAgentAddress

Puntero a una cadena terminada en null que especifica un nombre de host o una dirección IP. El nombre de host debe resolverse en una dirección IP, una dirección IPX (en notación 8.12) o una dirección Ethernet. Consulte la sección Comentarios de los formularios aceptables para los nombres de host y las direcciones IP.

[in] lpAgentCommunity

Puntero a una cadena terminada en null que especifica el nombre de la comunidad SNMP que se va a usar al comunicarse con el agente identificado por el parámetro lpAgentAddress .

[in] nTimeOut

Especifica el tiempo de espera de las comunicaciones en milisegundos.

[in] nRetries

Especifica el número de reintentos de comunicaciones. El tiempo de espera especificado en el parámetro nTimeOut se duplica cada vez que se transmite un reintento.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un puntero a una estructura de LPSNMP_MGR_SESSION . Esta estructura se usa internamente y el programador no debe modificarla. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

Si la función no se realiza correctamente, el valor devuelto es NULL. Para obtener información de error extendida, llame a GetLastError. GetLastError puede devolver el código de error SNMP_MEM_ALLOC_ERROR, que indica un error de asignación de memoria.

Esta función también puede devolver códigos de error de Windows Sockets.

Comentarios

Si es posible, use un nombre de host para identificar el agente SNMP en el parámetro lpAgentAddress . Los nombres de host solo se pueden proporcionar para los agentes si se carga TCP/IP y los nombres son nombres de host TCP/IP. No se pueden proporcionar nombres NetBIOS para hosts IPX.

El nombre y la dirección del destino SNMP, o la cadena a la que apunta el parámetro lpAgentAddress , debe cumplir uno de los siguientes formularios.

Nombre o dirección	Formulario (ejemplo)
Nombre de host	merlin o merlin.microsoft.com
Dirección IPv4	157.57.8.160
Dirección IPv6	3ffe:8311:ffff::b3ff:fe88:c33
Dirección MAC	00aa00bbccddd
Dirección IPX	00006112.00aa00bbccddd

 

Las aplicaciones no deben usar el puntero LPSNMP_MGR_SESSION devuelto por esta función para llamar a la función SnmpMgrRequest en el contexto de un subproceso diferente.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	mgmtapi.h
Library	Mgmtapi.lib
Archivo DLL	Mgmtapi.dll

Consulte también

Funciones SNMP

Introducción al Protocolo simple de administración de redes (SNMP)

SnmpMgrClose

SnmpMgrRequest