GdiComment

  BOOL GdiComment(hdc, nSize, lpData)    
  HDC hdc; /* handle of a device context */
  UINT nSize; /* size of text buffer */
  LPBYTE lpData; /* address of text buffer */

The GdiComment function copies the comment from the buffer at which lpData points into the enhanced metafile identified by hdc.

Parameters

hdc

Identifies the device context.

nSize

Specifies the length of the comment buffer in bytes.

lpData

Points to the buffer that contains the comment.

Return Value

The return value is TRUE if the function is successful. Otherwise, it is FALSE.

Comments

A comment may include any private information. Examples are the the source of the picture and the date upon which it was created. (A comment should begin with an application signature followed by the data.)

Comments should not contain application-specific data nor should they contain position-specific data. (Position-specific data is data specifying the location of a record—it should not be included since one metafile may be embedded within another metafile.)

See Also

CreateEnhMetaFile