Función SnmpDuplicatePdu (winsnmp.h)

Artículo
04/03/2024

[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 SnmpDuplicatePdu de WinSNMP duplica la unidad de datos del protocolo SNMP (PDU) que identifica el parámetro PDU , asignando cualquier memoria necesaria para la PDU duplicada.

Sintaxis

HSNMP_PDU SNMPAPI_CALL SnmpDuplicatePdu(
  [in] HSNMP_SESSION session,
  [in] HSNMP_PDU     PDU
);

Parámetros

[in] session

Controle la sesión de WinSNMP.

[in] PDU

Identificador de la PDU que se va a duplicar. La función SnmpDuplicatePdu proporciona un identificador único para cada PDU dentro de la aplicación que realiza la llamada.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un identificador que identifica la nueva PDU duplicada.

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
SNMPAPI_NOT_INITIALIZED	La función SnmpStartup no se completó correctamente.
SNMPAPI_ALLOC_ERROR	Error durante la asignación de memoria.
SNMPAPI_SESSION_INVALID	El identificador de sesión no es válido.
SNMPAPI_PDU_INVALID	El identificador PDU no es válido.
SNMPAPI_OTHER_ERROR	Error desconocido o indefinido.

Comentarios

Para liberar recursos asignados por la función SnmpDuplicatePdu para una nueva PDU, una aplicación WinSNMP debe llamar a la función SnmpFreePdu .

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