Create a C++ connector

Create a new connector with Microsoft Visual Studio 2015 following these steps:

1. Create a new ATL project (check MFC support if you want to use MFC).
   
2. Add a new class to the project and select simple ATL object as the class template.
   

   Attention

   It is important that the connector ProgId must be the name of the DLL file (without the path and the extension) followed by the '.Connector' literal, for example: "FTPConnector.Connector" "SharePoint.Connector".

3. Fill the short name and the ProgID field on the first page of the new class wizard, then click Finish.
   
4. In the class view, right click the new class and select Add-> Implement Interface.
   
5. Navigate to and select the DMSConnector.tlb file. Go to the project directory if you copied the file there.
   
6. Add the IDMSConnector interface to the list along with the IPropertyPageHandler if you want to implement them in one class.
   
7. Set up the connector. There are two possible methods to set up a connector for Power PDF, see How to set up a new connector for details.
8. Set up logging to follow which calls are made to the connector. See Logging for details.

After that, implementing the real functionality of connectors can take place in the following order:

1. Enable Power PDF to load the connector and make the Open From.../Save To... items available on the UI. To do this, use the following functions:
   Init, Shutdown, ConnectorName (get), ParentWindow (set)
2. Make the connector visible on the user interface of Power PDF. Call the following functions: MenuGetNumberOfItems, MenuGetMenuItem, MenuGetItemState
3. Make DMS connector functionality accessible in Power PDF:
   • To enable open (download, checkout, for example) and close (check-in, for example) operations, use these functions: DocSelectFiles, DocOpen, DocGetTitle, DocGetLocalFile, DocGetOpenMode, DocClose
   • To enable uploading (check-in) of local files, use the DocAddNew function.
   • To enable uploading (save, check-in) of open files, use the DocPrepareSave, DocSave functions.
   The following functions are optional. Implement these if connector functionality requires: FileIsFromDms, DocModified, Create, UpdateData.

Create a C++ connector from an SDK sample

You can also create a new connector by modifying the FTP Connector project included in the SDK package/by performing the following steps:

1. Change the CLSID and ProgId of the projects.
2. Create a new GUID with the help of Microsoft Visual Studio, and replace the current GUID in the connector.cpp and .rgs files with it.
3. In the .rgs file, update the ProgId. The sample projects automatically register themselves both for COM and as a connector if you run regsvr32.exe with the compiled DLL.

After modifying the CLSID, continue modifying the connector by following the same order as you would with a completely new one.