To manipulate the multiple byte characters like Japanese, Korean, Chinese with Notes C API, you will need to convert Native characters Code to LMBCS.

As per C++/CLI supports UNICODE as default, I recommend to use UNICODE for manipulating the String values on C++/CLI.

› Translate from UNICODE (managed code) to LMBCS

Here I wrote how to convert UNICODE characters to LMBCS so that C API functions can understand them.

Step1. First of all, Marshal String to UNICODE String Pointer from Managed code. Marshal::StringToHGlobalUni() function  allocates the string data to global memory, so you will need to release the data after all.

String^ idfile = gcnew String(“ほげほげ.id”);
// Convert String to UNICODE String Pointer ( memo:StringToCoTaskMemAuto )
System::IntPtr ptrIdfile = System::Runtime::InteropServices::Marshal::StringToHGlobalUni( idfile );

Step2. Translate string from UNICODE to LMBCS format with OS_TRANSLATE_UNICODE_TO_LMBCS as 1st parameter of OSTranslate.

WORD    idfile_len = 2*(wcslen(static_cast<const wchar_t*>(ptrIdfile.ToPointer())));
char    idfile_lmbcs[MAXBUFFER+1];
OSTranslate(OS_TRANSLATE_UNICODE_TO_LMBCS, (char*)ptrIdfile.ToPointer(), idfile_len, idfile_lmbcs, MAXBUFFER );

Now you can pass LMBCS characters which is contained in idfile_lmbcs to Notes C API functions.

After using the string, don’t forget to free the pointer which is allocated by Marshal::StringToHGlobalUni().

System::Runtime::InteropServices::Marshal::FreeHGlobal( ptrIdfile );

For example, To get the multiple byte characters from notes documents, you also need to translate string from LMBCS to UNICODE. Below is the steps.

Step1. Get the value as Char format.

char item_value[MAXTEXTBUFFER+1];
// for example, calling NSFItemConvertValueToText() to get the Text from item value.
text_len = NSFItemConvertValueToText( item_type,
value_block,
item_len,
item_value,
buffer_len,
0);

Step2. Translate text string from LMBCS to UNICODE. In this case you need to use OS_TRANSLATE_LMBCS_TO_UNICODE as 1st parameter of OSTranslate().

char    item_value_lmbcs[MAXTEXTBUFFER+1];
OSTranslate(OS_TRANSLATE_LMBCS_TO_UNICODE, item_value, text_len, item_value_lmbcs, MAXTEXTBUFFER );

Step3.Get string as managed code by converting with following code.

String^ itemValue = System::Runtime::InteropServices::Marshal::PtrToStringUni( (IntPtr)item_value_lmbcs );

I wrote this article since there are little information about how to use Notes C API on C++/CLI with CLR.

Below is the settings to configure the DLL project with using Notes C API on C++/CLI. I am using Visual Studio 2005 Standard Edition.

1. After creating New Project, Go to [Project] – [Properties]
2. Go to [Configuration Properties] – [General] from left Navigation.
   Configure Dynamic Library(.dll) and Common Language Runtime Support (/clr)
   

   Configuration Properties - General

3. Go to [C/C++] – [General]
   Add Notes C API include folder into [Additional Include Directories]
   

   C/C++ - General

4. Go to [C/C++] – [Peprocessor]
   Add W32;WIN32 into [Preprocessor Definitions]
   

   C/C++ - Preprocessor

5. Go to [C/C++] – [Code Generation]
   Configure Multi-threaded DLL (/MD) into [Runtime Library]
   

   C/C++ - Code Generation

6. Go to [Linker] – [General]
   Add C Notes API Library into [Additional Include Directories]
   

   Linker - General

7. Go to [Linker] – [Input]
   Add notes.lib into [Additional Dependencies]
   

   Linker - Input

   Point the relative path if you need (i.e) notesapi\lib\mswin32\notes.lib

That’s all!
Enjoy C++/CLI programming with Notes C API!