Finalidad
Recibe un puntero de sesión de examen, un descriptor de contexto y una opción (DES_EXTENDED o DES_FAST) que indica si el documento de texto debe analizarse con o sin la utilización de un diccionario. Prepara el documento de texto que corresponde al descriptor de contexto para obtener el texto del documento y la información de resaltado y devuelve un descriptor de contexto de documento que se utiliza para llamar iterativamente a DesGetMatches.
Sintaxis
DESRETURN DesOpenDocument (DESBROWSESESSION BrowseSession, SQLCHAR *pHandle, DESUSHORT HandleLength, DESMATCHMODE MatchMode, DESHANDLE *pDocumentHandle, DESMESSAGE *pErrorMessage);
Argumentos de la función
Tabla 15. Argumentos de DesOpenDocument
Uso
DES_FAST y DES_EXTENDED hacen referencia al uso del proceso lingüístico para buscar los términos que se han de resaltar en el texto examinado. Consulte el apartado Proceso lingüístico para examen para obtener más información. Especifique DES_FAST para utilizar el análisis de texto básico y DES_EXTENDED para utilizar la comparación ampliada.
Para la correlación entre los tipos de datos SQL y los tipos de datos C, debe utilizar el nombre simbólico SQL SQL_VARBINARY para un descriptor de contexto. El tipo de variables de sistema principal que apuntan a la representación C de valores TextHandle es SQLCHAR*.
DB2 Text Extender asigna el almacenamiento para la información de examen. El programa de aplicación debe liberar este almacenamiento y los recursos relacionados llamando a DesFreeBrowseInfo.
Puesto que los valores de TextHandle son datos de bits y contienen varios caracteres '\0', debe especificar la longitud de pHandle.
El llamante debe tener acceso de lectura para la tabla que contiene el documento de texto al que pHandle hace referencia.
Códigos de retorno
Restricciones
Sólo puede llamarse a esta función después de haber iniciado una sesión de examen llamando a DesStartBrowseSession.