Compartir a través de


Función SnmpMgrStrToOid (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 administración remota de Windows, que es la implementación de Microsoft de WS-Man.]

La función SnmpMgrStrToOid convierte el formato de cadena de un identificador de objeto en su estructura de identificador de objeto interna. Esta función es un elemento de la API de administración de SNMP.

Sintaxis

BOOL SNMP_FUNC_TYPE SnmpMgrStrToOid(
  [in]  LPSTR               string,
  [out] AsnObjectIdentifier *oid
);

Parámetros

[in] string

Puntero a una cadena terminada en null que se va a convertir.

[out] oid

Puntero a una variable de identificador de objeto para recibir el valor convertido.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero.

Comentarios

Si la función se realiza correctamente, llame a la función SnmpUtilOidFree para liberar la memoria asignada para el identificador de objeto convertido.

Si una aplicación pasa un identificador de objeto válido a SnmpMgrStrToOid, pero no puede obtener la variable solicitada, la sintaxis del grupo del sistema y el identificador de objeto no son correctos. Esto ocurre porque SnmpMgrStrToOid supone que el identificador de objeto está bajo la MIB de Internet del subárbol de administración.

Siempre debe preceder al identificador de objeto con un punto (.) para obtener el grupo de sistema correcto (por ejemplo, ".1.3.6.1.2.1.1"). Si una aplicación pasa la variable "1.3.6.1.2.1.1", SnmpMgrStrToOid no puede interpretar correctamente el identificador de objeto.

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)

SnmpMgrOidToStr

SnmpUtilOidFree