DrgQueryStrName - Example Code

This example shows how to obtain the contents of a string given that the string handle is known. The string handle must have been originally created with the DrgAddStrHandle function.

#define INCL_WINSTDDRAG  /* Direct Manipulation (Drag) Functions */
#define INCL_DOSMEMMGR   /* Memory Management Functions for      */
                         /* DosAllocMem                          */
#include <OS2.H>

HSTR   hstr;             /* Handle to a string.  The handle must */
                         /* have been created with               */
                         /* DrgAddStrHandle.                     */
PSZ    pBuffer;          /* Buffer where the null-terminated     */
                         /* string is returned                   */
ULONG  ulStrlen;         /* String length                        */
ULONG  ulBytesRead;      /* Number of bytes read                 */
ULONG  rc;               /* Return code                          */

ulStrlen = DrgQueryStrNameLen(hstr) + 1;

rc = DosAllocMem((PVOID *) pBuffer,
                (LONG)ulStrlen,
                fPERM |
                PAG_COMMIT);

/*****************************************************************/
/* The ulBytesRead parameter contains the number of bytes        */
/* actually written to the memory pointed to by pBuffer          */
/*****************************************************************/
ulBytesRead = DrgQueryStrName(hstr,
                     ulStrlen,      /* Number of bytes to copy   */
                     pBuffer);