4.1 Header Files

The gwoapi.h file is the original header file and contains all interfaces defined for the GroupWise Object API system in the original interface.

The gwoapi2.h file was created after the GroupWise 6.0, Service Pack 1 release. It contains all the original interfaces and many new interfaces, properties, and methods that have been defined since the original interface.

If you are writing new code, you can use the gwoapi.h file to access the GroupWise Object API. However, you will not be able to use any of the new interfaces, methods, or properties.

If you use the gwoapi2.h file, it will give you access to all interfaces, methods, and properties supported in the GroupWise Object API release version 6.0 SP1.

For the Messages collection and Account2 new GUID, the new code must handle a possible E_NOINTERFACE error that is returned when running against earlier versions of GroupWise. If E_NOINTERFACE is returned, ask for the interface from the older version (Account2Old or MessagesOld). If the second call is successful, all older methods and properties of the interface can be called.

For example, if the code logs into a system, it will receive a DIGWAccount pointer on successful return. You can then request the Account2 interface using the new GUID in the gwoapi2.h file. If it returns an error, request an older Account2 interface (without the new methods) by using the Account2Old GUID defined in the gwoapi2.h file. If this call succeeds, the code can call all the original Account2 methods and properties. (If this second interface is used to call a new method, an error will occur.)

Some examples for handling the new Account2 GUID and a possible E_NOINTERFACE error follow (assuming that pGWApp has been previously retrieved from the OLE system and that the vrName, vrCmdLine, vrPwrd, vrPrompt, and vrReserved variants were previously built). Note that the following example is for the Account2 interface. However, similar code could be written for other objects such as the new Messages collection.

DIGWAccount   pdAcct; 
IGWAccount2   pAcct; 
BOOLbNewGUID = TRUE; 
 
hr=pGWApp->Login(vrName, vrCmdLine, vrPwrd, vrPrompt, 
  vrReserved, &pdAcct); 
 
if(SUCCEEDED(hr)) 
{ 
   hr=pdAcct->QueryInterface(IID_IGWAccount2, &pAcct); 
   if(FAILED(hr)) 
   { 
      bNewGUID = FALSE; 
      hr = pdAcct->QueryInterface(IID_IGWAccount2Old, 
&pAcct);  
      if(FAILED(hr)) 
      { 
         //execute error condition 
         //could not retrieve either account pointer 
      } 
   } 
}

Or, if the code needs to use the new methods but wants to include the gwoapi2.h file, you can take the DIGWAccount pointer from login and call for an Account object using the Account2Old GUID at all times. This code can then be run against any GroupWise version. The following sample code is the same as the preceding example but has been modified to use only the old Account2 GUID:

DIGWAccount   pdAcct; 
|IGWAccount2  pAcct; 
 
hr=pGWApp->Login(vrName, vrCmdLine, vrPwrd, vrPrompt, 
  vrReserved, &pdAcct); 
 
if(SUCCEEDED(hr)) 
{ 
   hr=pdAcct->QueryInterface(IID_IGWAccount2Old, &pAcct); 
   if(FAILED(hr)) 
   { 
      //execute error condition 
      //could not retrieve either account pointer 
   } 
}

4.2 Hits Per Source Limit

The GroupWise engine currently contains a limit of 2500 hits per source on any query driven by the Object API. For example, if you are querying ten libraries, the engine will return no more than 2500 hits for each library.

4.3 AddExistingMethod

The AddExistingMethod (Messages object) method has the following problems:

• The current version only allows the Private, Read, and opened flags to be set in the MessageStatus bitmask.
• AddExistingMessage does not preserve any flags in the MessageStatus bitmask other than Private for a draft message. GroupWise assumes that a draft message is read, opened, and delivered, so these values are overwritten. (The other flags are lost for the above reason.)
• If a FROM_TEXT property is set on a draft message and the display name has more characters than FROM_TEXT, the new SenderDisplayName is used, but truncated.