NSFDbGetNoteInfoExt
Function : Database
NSFDbGetNoteInfoExt - Get the note's the Originator ID (OID) structure, the time and date the note was last modified, the NOTE_CLASS_xxx, the time and date it was added to the database, the number of response documents and its parent's NoteID.
#include <nsfdb.h>
STATUS LNPUBLIC NSFDbGetNoteInfoExt(
DBHANDLE hDB,
NOTEID NoteID,
OID far *retNoteOID,
TIMEDATE far *retModified,
WORD far *retNoteClass,
TIMEDATE *retAddedToFile,
WORD *retResponseCount,
NOTEID *retParentNoteID);
This function takes a database handle and note ID. It returns the note's the Originator ID (OID) structure, the time and date the note was last modified, the NOTE_CLASS_xxx, the time and date it was added to the database, the number of response documents (or 0 if is has no children) and its parent's NoteID (or 0 if it does not have a parent). It is the database level equivalent of three calls to NSFNoteGetInfo(), but requires a disk I/O or network I/O to obtain the information (and thus, it is fairly expensive to use).
Parameters : Input : hDB - A handle to an open Domino database.
NoteID - The NOTEID of the note whose particulars you wish to retrieve.
Output : (routine) - Return status from this call -- indicates either success or what the error is. The return codes include:
NOERROR - Successfully retrieved the note information.
ERR_NOTE_DELETED - Document has been deleted.
ERR_xxx - Errors returned by lower level functions. There are so many possible causes, that It is best to use the code in a call to OSLoadString and display/log the error for the user.
retNoteOID - Returns the populated ORIGINATORID (OID) structure containing the database creation time/date, note creation time/date, note sequence number, and the sequence time/date (when added to database).
retModified - Returns the populated TIMEDATE structure containing the note's last modified time and date normalized to Greenwich Mean Time (GMT).
retNoteClass - Returns pointer to NOTE_CLASS_xxx in a WORD, value indicates the type of note.
retAddedToFile - Returns the populated TIMEDATE structure containing when the note was added to this replica of the database.
retResponseCount - Returns the number of response documents a note has.
retParentNoteID - Returns the NOTEID of the parent document for this note.
Sample Usage :
/* Find some SPECIAL notes: Policy and then designer's Help */
if (error_status = NSFDbGetSpecialNoteID(db_handle_src,
SPECIAL_ID_NOTE | NOTE_CLASS_INFO,
&policy_nid_src))
{
if (ERR(error_status) == ERR_SPECIAL_ID)
printf("\n%s has no Policy Note\n", src_name);
else
goto Exit;
}
else
{
if (error_status = NSFDbGetNoteInfoExt(db_handle_src,
policy_nid_src,
&policy_oid_src,
&policy_lastmod_td,
&policy_noteclass,
&policy_addedtofile_td,
&policy_responses,
&policy_parent_noteid))
goto Exit;
printf("Policy Note ID = %08lX\n", policy_oid_src.Note);
}