Skip to content

NSFDbNoteLock

Function : Note
NSFDbNoteLock - Lock a note.

#include <nsfnote.h>
STATUS LNPUBLIC NSFDbNoteLock(

    DBHANDLE  hDB,
    NOTEID  NoteID,
    DWORD  Flags,
    char *pLockers,
    DHANDLE *rethLockers,
    DWORD *retLength);
Description :

This function adds an "authors" field to a note which contains a list of "writers" who will be able to update the note. Any user will be able to open the note, but only the members contained in the "authors" field are allowed to update the note.

This function will only succeed if the database option "Allow document locking" is set. Please refer to the Domino documentation for a full description of document locking.

Parameters : Input : hDB - The handle of the open database that contains the note to be locked.

NoteID - The ID of the note that you want to lock.

Flags - Flags to control how a note is locked. See NOTE_LOCK_xxx.

pLockers - A pointer to a null-terminated character string containing the name or names to be added to the authors field. Multiple names must be delimited by a semi-colon (;).

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

NOERROR - Success.

ERR_NOTE_LOCKED - The note is already locked. You can determine who locked the note by setting the NOTE_LOCK_STATUS flag and using the rethLockers parameter.

ERR_xxx - Errors returned by lower level functions: (memory management, file operations, etc.). 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 as your default error handling.

rethLockers - If the note is already locked and you specify the NOTE_LOCK_STATUS flag, this is the handle to the "lockers".

retLength - Length of the string associated with rethLockers.

See Also : NSFDbNoteUnlock