La función HANDLE_LIST busca documentos de texto utilizando un argumento de búsqueda y devuelve un valor de tipo DB2TEXTHLISTP o DB2TEXTFHLISTP que apunta a una lista de descriptores de contexto para los documentos encontrados.
Nota: | Sólo se puede acceder al puntero para esta lista desde el ámbito de la sentencia de SQL que utiliza esta función. |
Si no se encuentran documentos que contengan el término o los términos de búsqueda, la lista de descriptores de contexto está vacía. Utilice la función NO_OF_DOCUMENTS para averiguar si la lista está vacía.
Si busca texto almacenado en una columna de una tabla base, utilice esta función sólo una vez por sentencia. Si busca texto almacenado en una columna de una vista y la vista se ha creado a partir de más de una tabla base (es decir, es una vista de uniones), utilice un descriptor de contexto para cada columna de descriptores de contexto como argumento de entrada de descriptor-contexto para la función HANDLE_LIST.
Consejo |
---|
Esta función es una característica de un release anterior de DB2 Text Extender. Se sigue soportando por razones de compatibilidad. Su funcionalidad se ha sustituido por la función de búsqueda SEARCH_RESULT. |
Sintaxis de la función
>>-HANDLE_LIST--------------------------------------------------> >----(--descriptor-contexto--,--argumento-búsqueda----)--------><
Parámetros de la función