MUMS API CUEL IMAN MLIM 2010/11/18

CUEL Module Function Description – This function allows the caller to request that the module name be added to the registry as an event source, a custom event log with the specified name be created, and then a handle to the new event log be retrieved and returned. Parameter: – [in] SourceName–The name of the module requesting the new event log. – [in] LogName–Name of the new custom event log. – [in] CategoryFile–A pointer to a Category DLL file. – [in] EventFile–A pointer to a Event DLL file. – [in] LogContentInformation–A pointer to a structure or file on events to be recorded in the log. BOOL CUELCreateCustomEventLog(LPCWSTR SourceName, LPCWSTR LogName, LPCWSTR CategoryFile, LPCWSTR EventFile, PVOID LogContentInformation)

CUEL Module Function Description: – Retrieves a registered handle to the specified event log. Parameter: – [in] SourceName- The name of the event source whose handle is to be retrieved. The source name must be a subkey of a log under the Eventlog registry key. HANDLE CUELRegisterEventSource(LPCTSTR SourceName)

CUEL Module Function Description: – Closes a write handle to the specified event log. Parameter: – [in] EventLogHandle- A handle to the event log. This handle is returned by the CUELRegisterEventSource function. BOOL CUELDeregisterEventSource(HANDLE EventLogHandle)

CUEL Module Function Description: – Writes an entry at the end of the specified event log. Parameter: – [in] EventLogHandle- A handle to the event log. This handle is returnedby the CUELRegisterEventSource function. – [in] Type- The type of event to be logged. – [in] Category- The event category. This is source-specific information;the category can have any value. – [in] EventId- The event identifier. The event identifier specifies the entry in the message file associated with the event source. BOOL CUELReportEvent (HANDLE EventLogHandle, WORD Type, WORD Category, DWORD EventId, PSID UserSid, WORD NumberStrings, DWORD EventDataSize, LPCWSTR *StringsPointer, PVOID EventData)

CUEL Module – [in] UserSid- A pointer to the current user's security identifier. This parameter can be NULL if the security identifier is not required. – [in] NumberStrings- The number of insert strings in the array pointed to by the stringsPointer parameter. A value of zero indicates that no strings are present. – [in] EventDataSize- The number of bytes of event-specific raw (binary) data to write to the log. If this parameter is zero, no event-specific data is present. – [in] StringsPointer- A pointer to a buffer containing an array of null-terminated strings that are merged into the message before Event Viewer displays the string to the user. This parameter must be a valid pointer (or NULL), even if numberStrings is zero. Each string has a limit of 32K characters. – [in] EventData- A pointer to the buffer containing the binary data. This parameter must be a valid pointer (or NULL), even if the eventDataSize parameter is zero.

iMAN Module Function Description: – This function allows the caller to request a notification action of specified type to be carried out. Parameter: – [in] NotificationActionType –A notification action type. – [in] EnentHandle- The event that will be signaled while the asynchronous function is done – [in] ActionDescriptor –An action descriptor of the specified action type. – [in] IMANAsyncResult- The data block storing the result returned by IMAN Module BOOL iMANSendNotification(IMANNOTIFICATIONACTIONTYPES NoticationActionType, HANDLE EventHandle, PVOID ActionDescriptor, IMANASYNCRESULT* IMANAsyncResult );

MLIM Module Function Description: – This function allows the caller to open a specified type of container on smart cabinet. Parameter: – [in] EventHandle–The event that will be signaled while the asynchronous function is done – [in] MedicationID –The MedicationID that will be opened – [in] MLIMAsyncResult–The data block storing the result returned by MLIM Module BOOL MLIMOpenContainer( LPCTSTR MedicationID);

MLIM Module Function Description: – This function will be called when the smart cabinet is in medication preparation status. Parameter: – [in] EventHandle–The event that will be signaled while the asynchronous function is done – [in] MLIMAsyncResult–The data block storing the result returned by MLIM Module BOOL MLIMStartPrepareMedication(HANDLE EventHandle, MLIMASYNCRESULT* MLIMAsyncResult);

MLIM Module Function Description: – This function will be called when the smart cabinet is finished medication preparation. Parameter: – [in] EventHandle–The event that will be signaled while the asynchronous function is done – [in] MLIMAsyncResult–The data block storing the result returned by MLIM Module BOOL MLIMEndPrepareMedication(HANDLE EventHandle, MLIMASYNCRESULT* MLIMAsyncResult);

MLIM Module Function Description: – This function will be called when the smart cabinet is in medication preparation status and create a mapping table. Parameter: – [in] MedicationID–The MedicationID that will be mapped BOOL MLIMMapMedicationIDAndContainerID(LPCTSTR MedicationID);

MLIM Module Function Description: – This function allows the caller to check if the medication is in the smart cabinet or not. Parameter: – [in] MedicationID–The MedicationID that will be checked BOOL MLIMIsMedicationIDInCabinet(LPCTSTR MedicationID);