INFO: What Do the cmiCommandDispatch() Errors Mean?

Error 0

• Description: Success

Back to the top

Error -1

• Description: Microsoft Word is invisible, or not running.
• Suggestion: Start Microsoft Word before executing.

Back to the top

Error -2

• Description: Win32Cmi.dll's shared memory block was not big enough.
• More Information: The default size is 131072.
• Suggestion: Recompile the Win32Cmi project with a bigger size.

Back to the top

Error -3

• Description: Could not obtain Microsoft Word's thread ID.
• More Information: The Win32 API GetWindowThreadProcessId() failed.

Back to the top

Error -4

• Description: Win32Cmi.dll could not install its WH_GETMESSAGE hook.
• More Information: The Win32 API SetWindowsHookEx() failed.

Back to the top

Error -5

• Description: The current instance of Microsoft Word was not the original instance hooked by the Win32Cmi Dll.
• More Information: Win32Cmi.dll's hooked thread id doesn't match the current Microsoft Word thread id. Win32Cmi.dll is only designed to work with a specific instance of Microsoft Word.
• Suggestion 1: Use CMI with only one Microsoft Word instance.
• Suggestion 2: Use OLE Automation as an alternative to CMI.
• Suggestion 3: Modify the Win32Cmi project yourself to support multiple instances of Microsoft Word.

Back to the top

Error -6

• Description: Win32Cmi.dll could not create an event object.
• More Information: The Win32 API CreateEvent() failed.

Back to the top

Error -7

• Description: Win32Cmi.dll could not create a file-mapping object.
• More Information: The Win32 API CreateFileMapping() failed.

Back to the top

Error -8

• Description: Win32Cmi.dll's call to MapViewOfFile() failed.

Back to the top

Error -9

• Description: Time-out (default=60 seconds).
• More Information: Win32Cmi.dll calls WaitForSingleObject() with a time-out value of 60000 milliseconds (60 seconds). If the return value is not WAIT_OBJECT_0, then cmiCommandDispatch() returns -9.
• Suggestion 1: The calling thread may be in a synchronous context with Word. Try calling from a separate thread.
• Suggestion 2: Increase time-out value in the Win32Cmi project.

Back to the top

Errors 5001 thru 5034

• Description: General CAPI error.
• More Information: This code is defined and described in WdError.h.
• Suggestion: Lookup error in WdError.h, and modify parameters to cmiCommandDispatch().

Back to the top