Función SnmpOidCopy (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 SnmpOidCopy de WinSNMP copia un identificador de objeto SNMP, asignando cualquier memoria necesaria para la copia.
Sintaxis
SNMPAPI_STATUS SNMPAPI_CALL SnmpOidCopy(
[in] smiLPCOID srcOID,
[out] smiLPOID dstOID
);
Parámetros
[in] srcOID
Puntero a una estructura smiOID que se va a copiar.
[out] dstOID
Puntero a una estructura smiOID para recibir una copia del identificador de objeto especificado por el parámetro srcOID .
Valor devuelto
Si la función se realiza correctamente, el valor devuelto es el número de subidentificadores en el identificador de objeto copiado. Este número también es el valor del miembro len de la estructura smiOID a la que apunta el parámetro dstOID .
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 especificando un valor NULL en su parámetro de sesión . 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 srcOID no es válido. |
|
Se produjo un error desconocido o no definido. |
Comentarios
En la entrada, la función SnmpOidCopy omite los miembros de la estructura smiOID a la que apunta el parámetro dstOID . La implementación de Microsoft WinSNMP sobrescribe los miembros smiOID si la función se completa correctamente.
La aplicación WinSNMP debe llamar a la función SnmpFreeDescriptor para permitir que la implementación libere los recursos asignados para el miembro ptr de la estructura smiOID a la que apunta el parámetro dstOID . Para obtener más información, consulte Conceptos de winSNMP Administración de datos y Descriptores winSNMP de freeing.
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 |