RegisterClipboardFormat

2.x

	UINT RegisterClipboardFormat(lpszFormatName)
	LPCSTR lpszFormatName;	/* address of name string	*/

The RegisterClipboardFormat function registers a new clipboard format. The registered format can be used in subsequent clipboard functions as a valid format in which to render data, and it will appear in the clipboard's list of formats.

Parameters

lpszFormatName

Points to a null-terminated string that names the new format.

Return Value

The return value indicates the newly registered format. If the identical format name has been registered before, even by a different application, the format's reference count is incremented (increased by one) and the same value is returned as when the format was originally registered. The return value is zero if the format cannot be registered.

Comments

The format value returned by the RegisterClipboardFormat function is within the range 0xC000 through 0xFFFF.