Issue a create note request to create a new note with the indicated content. The create request is rejected if the named note already exists.

If the create note request is successful, the tag value, instance number, connection identifier, persistence attribute, and note size are also set for the note. The count of notes in the note pad is incremented by one.

The note content is determined by the IXCNOTE keywords NOBUFFER, BUFFER and BUFLEN. If either NOBUFFER or a BUFLEN value of zero is specified, a null note is created. If the BUFLEN value is nonzero, the indicated number of bytes of data are fetched from the BUFFER area and stored in the note. If nonzero, the BUFLEN value must equal a supported note size.

The create request is rejected if the note pad is either full or constrained. A note pad is full if the number of notes in the note pad equals the number of notes requested by the creator of the note pad. A note pad is constrained if XCF is unable to create the note even though the note pad is not full. See Constrained conditions for more information. You need to determine how your program will respond to these conditions. It might be possible to delete some notes to make space available for new notes. It might be reasonable to reissue the request, perhaps after a short delay to allow time for the condition to clear.