Home page  
Help >
ddlGetMemoByTxtPtr() - read the contents of a MEMO field
Version 7.11
ddlGetMemoByTxtPtr() - read the contents of a MEMO field
ddlGetMemoByTxtPtr() - read the contents of a MEMO field
    
   ddlGetMemoByTxtPtr()
    
      Prototype:
         void ddlGetMemoByTxtPtr(
            CONTROL *ctl,
            WtChar8 *OptnStr,
            WtChar8 *ArgList,     /* command argument list */
            WtChar8 *TxtPtr,      /* Text Pointer string */
            WtChar8 *Image,       /* destination for memo field image */
            WtInt32 ImageMax)     /* size of Image memory block */
                                  /* ImageMax must be >= 512 */
                                  /* ImageMax must be a multiple of 512 */
                                  /* For most efficient operation, ... */
                                  /* ImageMax should be >= anticipated block size + 512 */
    
      Permitted values in OptnStr:
         B  - Read BLOB data
    
      The format of 'ArgList' is:
         <table-name> <column-name> 
            where <table-name> is the ascii name of the desired table
                           in the data base.
                  <column-name> is the name of the desired Memo field
 
      Description of Parameter TxtPtr:
         WtChar8 *TxtPtr is a pointer to the contents of the <column-name> field.
    
      Description:
         Read a memo field from an open data base. If the 'B' option is not
         present, read an existing MEMO field and return in Image. If the
         resulting object length exceeds ImageMax-1, only the first ImageMax-1 
         characters are returned, followed by the null character.
    
         If the 'B' option is present, read an existing BLOB and return 
         in Image. If the resulting object length exceeds ImageMax,
         only the first ImageMax characters are returned; no null character
         is supplied.
          
      Values returned in Control Structure:
         ctl->Ans2 is the ImageLength being returned (including terminating zero)
         ctl->Ans3 is stored image length (including terminating zero); if ctl->Ans3 > ctl->Ans2, some data
            has not been returned

Copyright © 2019 , WhamTech, Inc.  All rights reserved. This document is provided for information purposes only and the contents hereof are subject to change without notice. Names may be trademarks of their respective owners.