Función SnmpDuplicateVbl (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 SnmpDuplicateVbl de WinSNMP copia una lista de enlaces de variables para la sesión winSNMP especificada. Esta función devuelve un identificador a la lista de enlaces de variables copiados y asigna cualquier memoria necesaria para ella.
Sintaxis
HSNMP_VBL SNMPAPI_CALL SnmpDuplicateVbl(
[in] HSNMP_SESSION session,
[in] HSNMP_VBL vbl
);
Parámetros
[in] session
Controla la sesión de WinSNMP.
[in] vbl
Identificador de la lista de enlaces de variables que se va a copiar. La lista de enlaces de variables de origen puede estar vacía.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es un identificador de una nueva lista de enlaces de variables.
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 identificador de sesión no es válido. |
|
El parámetro vbl no es válido. |
|
Se produjo un error desconocido o no definido. |
Comentarios
La función SnmpDuplicateVbl crea una nueva lista de enlaces de variables para la sesión winSNMP especificada. Esta función inicializa la nueva lista con una copia de los datos de la lista de enlaces de variables de origen.
El identificador que devuelve la función SnmpDuplicateVbl es único entre los identificadores de lista de enlaces de variables que están activos dentro de la aplicación WinSNMP.
La aplicación WinSNMP debe liberar los recursos asociados a cada lista de enlaces de variables. Para ello, debe hacer coincidir cada llamada a las funciones SnmpCreateVbl y SnmpDuplicateVbl con una llamada correspondiente a la función SnmpFreeVbl . Para evitar pérdidas de memoria, una aplicación WinSNMP debe llamar a SnmpFreeVbl antes de reutilizar el identificador en una lista de enlaces de variables en una llamada posterior a SnmpCreateVbl o SnmpDuplicateVbl. Para obtener más información, consulte Conceptos de winSNMP Administración de datos.
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 | winsnmp.h |
| Library | Wsnmp32.lib |
| Archivo DLL | Wsnmp32.dll |