Función SnmpSetVb (winsnmp.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 SnmpSetVb de WinSNMP cambia las entradas de enlace de variables en una lista de enlaces de variables. Esta función también anexa entradas de enlace de variables nuevas a una lista de enlaces de variables existentes.
Sintaxis
SNMPAPI_STATUS SNMPAPI_CALL SnmpSetVb(
[in] HSNMP_VBL vbl,
[in] smiUINT32 index,
[in] smiLPCOID name,
[in] smiLPCVALUE value
);
Parámetros
[in] vbl
Controle la lista de enlaces de variables que se va a actualizar.
[in] index
Especifica una variable de entero largo sin signo que contiene la posición de la entrada de enlace de variables, dentro de la lista de enlaces de variables, si se trata de una operación de actualización. Si se trata de una operación de anexión, este parámetro debe ser igual a cero. Para obtener más información, vea la sección Comentarios que se muestra más adelante.
[in] name
Puntero a una estructura smiOID que representa el nombre de la variable que se va a anexar o cambiar. Para obtener más información, vea la sección Comentarios que se muestra más adelante.
[in] value
Puntero a una estructura smiVALUE . La estructura contiene el valor asociado a la variable especificada por el parámetro name .
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es la posición de la entrada de enlace de variable actualizada o anexada en la lista de enlaces de variables. Para obtener más información, vea la siguiente sección Comentarios.
Si se produce un error en la función, el valor devuelto es SNMPAPI_FAILURE. Para obtener información de error extendida, llame a SnmpGetLastError. La función SnmpGetLastError puede devolver uno de los siguientes errores.
| Código devuelto | Descripción |
|---|---|
|
La función SnmpStartup no se completó correctamente. |
|
Error durante la asignación de memoria. |
|
El parámetro vbl no es válido. |
|
El parámetro index no es válido. |
|
El parámetro name no es válido. |
|
El miembro de sintaxis de la estructura a la que apunta el parámetro value no es válido. |
|
Error desconocido o indefinido. |
Comentarios
Valores válidos para el intervalo de parámetros de índice de cero a n. El valor cero indica una operación de anexión. El valor n es el número total de entradas de enlace de variables en la lista de enlaces de variables. Una aplicación WinSNMP debe llamar a la función SnmpCountVbl antes de llamar a SnmpSetVb para obtener el número total de entradas de enlace de variables.
Si la función realiza correctamente una operación de actualización, el valor devuelto es igual al valor del parámetro de índice . Si la función anexa una entrada de enlace de variable, el valor devuelto es n + 1.
Si el parámetro name no es NULL, pero el parámetro value es NULL, la implementación de Microsoft WinSNMP inicializa la nueva entrada de enlace de variable con el miembro value establecido en NULL y con el miembro de sintaxis establecido en SNMP_SYNTAX_.
Si el parámetro de índice no es igual a cero y el parámetro name es NULL, la implementación de Microsoft WinSNMP solo actualiza el valor de la variable a la que apunta el parámetro de índice .
Requisitos
| 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 | winsnmp.h |
| Library | Wsnmp32.lib |
| Archivo DLL | Wsnmp32.dll |