In This Topic ▼

L_GetMarkers

Summary

Gets a copy of the last markers set with L_SetMarkers.

Syntax

#include "l_bitmap.h"

L_LTFIL_API L_INT L_GetMarkers(phMarkers, uFlags)

Parameters

L_VOID ** phMarkers

Pointer to a variable to be updated with a handle to a copy of the collection of markers last set with L_SetMarkers. This cannot be NULL.

L_UINT uFlags

Reserved for future use. Pass 0.

Returns

Value	Meaning
SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

Since you have a copy, anything you do with the handle will not modify the markers, which can be saved by calling a Save function. To modify the markers being saved, call L_SetMarkers.

When the marker collection handle is no longer needed, use L_FreeMarkers function to free it.

When calling L_GetMarkers, the phMarkers parameter cannot be NULL. However, if no markers have been set using L_SetMarkers, the phMarkers parameter will be updated with NULL when the function returns.

Required DLLs and Libraries

LTFIL
For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Win32, x64, Linux.

Example

This example tells you whether you have set any markers or not

L_INT GetMarkersExample(L_VOID) 
{ 
   L_INT nRet; 
   HANDLE hMarkers; 
 
   if((nRet = L_GetMarkers(&hMarkers, 0)) != SUCCESS) 
   { 
      MessageBox(NULL, TEXT("Error calling L_GetMarkers!"), TEXT("ERROR"), MB_OK); 
      return nRet; 
   } 
   else 
   { 
      if(hMarkers) 
      { 
         MessageBox(NULL, TEXT("You have set markers!"), TEXT("Info"), MB_OK); 
         L_FreeMarkers(hMarkers); 
      } 
      else 
         MessageBox(NULL, TEXT("You have not set any markers!"), TEXT("Info"), MB_OK); 
   } 
    
   return SUCCESS; 
}