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►  ◄Changes►               ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
#define INCL_GPIMETAFILES
 
BOOL GpiQueryMetaFileBits(hmf, off, cbBuffer, pbBuffer)
HMF hmf;           /* metafile handle                           */
LONG off;          /* offset to the first metafile byte to copy */
LONG cbBuffer;     /* length in bytes of buffer                 */
PBYTE pbBuffer;    /* address of buffer for metafile data       */
 
The GpiQueryMetaFileBits function copies data from the metafile specified by
hmf to the buffer pointed to by the pbBuffer parameter. The function copies
the bytes of the metafile, up to the number of bytes specified by cbBuffer,
starting at the byte whose offset from the beginning of the metafile is
specified by the off parameter.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
hmf        Identifies the memory metafile.
 
off        Specifies the offset in bytes from the beginning of the metafile
           to the first byte to copy.
 
cbBuffer   Specifies the number of bytes of metafile data to copy.
 
pbBuffer   Points to the buffer to receive the metafile data. It must have
           the number of bytes specified by the cbBuffer parameter.
 
Return Value
 
The return value is GPI_OK if the function is successful or GPI_ERROR if an
error occurred.
 
Errors
 
Use the WinGetLastError function to retrieve the error value, which may be
one of the following:
 
     PMERR_INV_HMF
     PMERR_INV_METAFILE_LENGTH
     PMERR_INV_METAFILE_OFFSET
 
See Also
 
GpiQueryMetaFileLength, GpiSetMetaFileBits, WinGetLastError
 
                                      ♦