Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

◄Function Group►  ◄Overview►                          ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
#define INCL_GPIMETAFILES
 
LONG GpiQueryMetaFileLength(hmf)
HMF hmf;    /* metafile handle */
 
The GpiQueryMetaFileLength function returns the total length, in bytes, of
the metafile specified by hmf. The function is typically used to determine
the number of bytes of data to retrieve using the GpiQueryMetaFileBits
function.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
hmf        Identifies the metafile.
 
Return Value
 
The return value is the metafile length if the function is successful or
GPI_ALTERROR if an error occurred.
 
Errors
 
Use the WinGetLastError function to retrieve the error value, which may be
one of the following:
 
     PMERR_ALREADY_IN_ELEMENT
     PMERR_AREA_INCOMPLETE
     PMERR_CALLED_SEG_NOT_FOUND
     PMERR_DYNAMIC_SEG_SEQ_ERROR
     PMERR_ELEMENT_INCOMPLETE
     PMERR_IMAGE_INCOMPLETE
     PMERR_INSUFFICIENT_MEMORY
     PMERR_INV_HMF
     PMERR_INV_IN_AREA
     PMERR_INV_IN_ELEMENT
     PMERR_INV_IN_IMAGE
     PMERR_INV_IN_PATH
     PMERR_INV_ORDER_CODE
     PMERR_INV_ORDER_LENGTH
     PMERR_NOT_IN_AREA
     PMERR_NOT_IN_ELEMENT
     PMERR_NOT_IN_IMAGE
     PMERR_NOT_IN_PATH
     PMERR_PATH_INCOMPLETE
     PMERR_SEG_CALL_RECURSIVE
     PMERR_SEG_CALL_STACK_EMPTY
     PMERR_SEG_CALL_STACK_FULL
     PMERR_STOP_DRAW_OCCURRED
     PMERR_TRUNCATED_ORDER
 
See Also
 
GpiQueryMetaFileBits, GpiSetMetaFileBits
 
                                      ♦