Tema anterior: doSelectTema siguiente: getListValues


doQuery

Los siguientes parámetros se aplican al método doQuery:

Parámetro

Tipo

Description

SID

Entero

Identifica la sesión recuperada del inicio de sesión.

ObjectType

Cadena

Identifica el tipo de objeto (fábrica) para consultar.

WhereClause

Cadena

(Opcional) Identifica la cláusula Where para la consulta.

Description

Realiza una selección de tipo SQL para el tipo de objeto especificado. También devuelve un identificador de lista que indica una lista de las filas devueltas de la consulta, donde cada fila representa un objeto de CA SDM que coincide con la cláusula Where proporcionada. El autor de la llamada puede buscar valores de las filas de la lista con getListValues ().

Nota: Para obtener más información acerca de las cláusulas Where, consulte la sección "Cláusulas Where".

Importante: La lista de objetos se almacena en el servidor de CA SDM y consume recursos del sistema. El autor de la llamada es responsable de liberar la lista con freeListHandles(). Si se abandona una lista en la memoria, esta se podrá incrementar para el proceso más allá del límite de 2 GB dando lugar a una fuga de memoria. Esto puede causar un fallo del sistema.

Las listas creadas con esta función son homogéneas, lo que significa que todos los objetos son del mismo tipo, y estáticas, lo que implica que la lista nunca cambia, incluso si el cambio de datos de un objeto lo excluye de la cláusula Where inicial.

Resultado

Un identificador de lista que se debe liberar con freeListHandle().

Elemento XML

Tipo

Description

<listHandle>

Entero

Determina el identificador de lista.

<listLength>

Entero

Identifica la longitud de la lista generada.