Función SnmpDeleteVb (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 administración remota de Windows, que es la implementación de Microsoft de WS-Man.]
La función SnmpDeleteVb de WinSNMP quita una entrada de enlace de variable de una lista de enlaces de variables.
Sintaxis
SNMPAPI_STATUS SNMPAPI_CALL SnmpDeleteVb(
[in] HSNMP_VBL vbl,
[in] smiUINT32 index
);
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 identifica la entrada de enlace de variable que se va a quitar. Esta variable contiene la posición de la entrada de enlace de variable, dentro de la lista de enlaces de variables.
Los valores válidos para este parámetro están en el intervalo de 1 a n, donde 1 indica la primera entrada de enlace de variable en la lista de enlaces de variables y n es el número total de entradas de la lista de enlaces de variables. Para obtener más información, vea la siguiente sección Comentarios.
Valor devuelto
Si la función se realiza correctamente, se SNMPAPI_SUCCESS el valor devuelto.
Si se produce un error en la función, el valor devuelto se 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 de índice no es válido. |
|
El parámetro vbl no es válido. |
|
Se produjo un error desconocido o no definido. |
Comentarios
Una aplicación WinSNMP puede usar la función SnmpDeleteVb para eliminar entradas de enlace de variables no válidas. Cuando una unidad de datos de protocolo (PDU) de SNMP_PDU_RESPONSE incluye un error que indica una entrada de enlace de variable no válida, la aplicación puede llamar a SnmpDeleteVb para eliminar la entrada. A continuación, la aplicación puede volver a enviar la solicitud PDU con una llamada a la función SnmpSendMsg , sin la entrada de enlace de variables no válida en la lista de enlaces de variables. Las PDU de solicitud incluyen los tipos de datos SNMP_PDU_GET, SNMP_PDU_GETNEXT y SNMP_PDU_GETBULK PDU.
Una vez que la función SnmpDeleteVb elimina una entrada de enlace de variable, el valor de índice de todas las entradas después de la entrada eliminada disminuirá en uno. Una llamada a la función SnmpCountVbl devuelve el nuevo número total de entradas de la lista de enlaces de variables. El nuevo total es uno menor que el recuento devuelto por una llamada a SnmpCountVbl antes de la llamada actual a SnmpDeleteVb.
Si una aplicación WinSNMP llama a la función SnmpDeleteVb y elimina la última entrada de enlace de variable en una lista de enlaces de variables, el resultado es una lista de enlaces de variables vacía. La lista de enlaces de variables sigue teniendo un identificador válido y la aplicación WinSNMP debe liberar el identificador con una llamada a la función SnmpFreeVbl .
Los siguientes son valores válidos que se usarán para el parámetro de índice :
- Valor devuelto de una llamada a la función SnmpCountVbl
- Campo de índice de error de una SNMP_PDU_RESPONSE PDU devuelta por una llamada a la función SnmpRecvMsg
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 |