Skip to content


Function : HTML

#include <nsfnote.h>

    DHANDLE  hLinkText,
    WORD  LinkTextLength,
    NOTELINK far *NoteLink,
    char far *ServerHint,
    char far *LinkText,
    WORD  MaxLinkText,
    DWORD far *retFlags);
Description :

Converts a link to a note stored as tagged text to a NOTELINK structure. The text containing the link must be stored in a Domino memory object. The tagged text format for a note link is:

Link Title String 85250123:006E4567 OF85258901:00682345-ON8525ABCD:0065EF01 OF4E851234:A91A5678-ON85259ABC:004BDEF0 CN=Ann/O=Iris Database 'Sample Database', View 'Example View', Document 'Title of Note'

Parameters : Input : hLinkText - Handle to Notes memory object containing the link text.

LinkTextLength - Size, in bytes, of the link text.

MaxLinkText - Maximum number of bytes to copy to the LinkText address.

Output : (routine) - Return status from this call -- indicates either success or what the error is. The return codes include:

NOERROR - Conversion successful. ERR_LINK_FORMAT - Format of the link text is invalid.

NoteLink - The NOTELINK structure is written to this address.

ServerHint - The string in the tag is copied to this address.

LinkText - The string in the tag is copied to this address.

retFlags - Link flag bits are stored at this address (see the entry for LINKFLAG_xxx).

See Also : LINKFLAG_xxx NOTELINK NSFNoteLinkToText