This topic shows how to create a C++ add-in using Microsoft Visual Studio 2022. The add-in adds a menu item to the context-sensitive and Tools menus of vaults in File Explorer.

1. Create the C++ project.
    
   1. Start Microsoft Visual Studio as Administrator.
       
   2. Select File > New > Project.
      
   3. From the dropdowns, select C++, All platforms, All project types.
      
   4. Select ATL Project.
      
   5. Click Next.
       
   6. Enter Project name, Solution (Create new solution or Add to solution), Solution name (if Create new solution).
       
   7. For Location, click ... and navigate to the folder where to create your project.
       
   8. Click Create.
      

   9. Select Support options > Support MFC in the ATL Project dialog.
      
      

   10. Click OK to generate the project. If the ATL Project is missing, the Visual Studio Installer will suggest that you install any frameworks, SDKs, and tools that you need. For example, you may need to install the Desktop development with C++ workload. The workloads can be found by clicking Tools > Get Tools and Features > Desktop & Mobile. After installation, you may be asked to reboot to continue with updates to Visual Studio.

   11. You will see two projects in Solution Explorer, project_name and project_namePS. The project referenced in the following steps is project_name.
        

2. Modify the project's settings.

   1. Right-click the project in Solution Explorer, and select Add > New Item.
       

   2. Select ATL.
      

   3. Select ATL Simple Object.
       

   4. Click Add.
       

   5. Type MyAddIn in Short name.
       

   6. Click Next and Next.
       

   7. Select Custom in the Interface and Both in the Threading Model.
       

   8. Click Finish. 
       

   9. Select View > Class View and expand your project in the Class View window.
       

   10. Right-click CMyAddIn and select Add > Implement Interface. 
        

   11. Select Project and select the most recent SOLIDWORKS PDM Professional type library, Edm.tlb, from the Available type libraries list. 
       
       NOTE: If the type library is not in the list, you must copy Edm.tlb from the installation API folder to project_path\project_name\project_name. Then select File, browse to project_path\project_name\project_name, and select Edm.tlb.
        

   12. Select IEdmAddIn5 in Interfaces .
        

   13. Click the single right-arrow button to move IEdmAddIn5 to Implement Interfaces, and click Finish. 
       
       Two new methods, IEdmAddIn5::GetAddInInfo and IEdmAddIn5::OnCmd, are added to your class.
       

   14. Select File > Save All.
        

3. Implement IEdmAddIn5::GetAddInInfo by replacing STDMETHOD(GetAddInInfo)in MyAddin.h with the following code.
   
   STDMETHOD(GetAddInInfo)(EdmAddInInfo * poInfo, IEdmVault5 * poVault, IEdmCmdMgr5 * poCmdMgr)
   {
   
      AFX_MANAGE_STATE(AfxGetStaticModuleState());
   
      if (poInfo == NULL || poCmdMgr == NULL )
        return E_POINTER;
   
      //Return some information to the Properties dialog box
      poInfo->mbsAddInName= SysAllocString( L"My first add-in" );
      poInfo->mbsCompany = SysAllocString( L"The name of my company" );
      poInfo->mbsDescription= SysAllocString( L"This is a very nice add-in." );
      poInfo->mlAddInVersion = 1;
   
      //SOLIDWORKS PDM Professional 5.2 (or later) is required by this add-in
      poInfo->mlRequiredVersionMajor = 5;
      poInfo->mlRequiredVersionMinor= 2;
   
      //Add hooks and menu commands to SOLIDWORKS PDM Professional
      //Below is a menu command that appears in the Tools
      //and context-sensitive menus of a vault in File Explorer
      poCmdMgr->AddCmd( 1, bstr_t("My first menu command"), EdmMenu_Nothing, bstr_t(""), bstr_t(""), 0, 0 );
   
      return S_OK;
   }

4. Implement IEdmAddIn5::OnCmd by replacing STDMETHOD(OnCmd)in MyAddin.h with the following code.
   
   STDMETHOD(OnCmd)(EdmCmd * poCmd, SAFEARRAY * * ppoData)
   {
   
      AFX_MANAGE_STATE(AfxGetStaticModuleState());
   
      if (poCmd == NULL ||ppoData == NULL)
        return E_POINTER;
   
      MessageBox((HWND)poCmd->mlParentWnd, bstr_t("Hello World!"), bstr_t("SOLIDWORKS PDM Professional"), MB_OK );
   
      return S_OK;
   }
   
   NOTE: If you copy the code from this topic and paste it into the IDE, delete any characters or spaces that offend the compiler. On a 64-bit computer, you must replace L with bstr_t() for the strings in the MessageBox.
    

5. Specify the project configuration properties:

   1. Right-click the project name in Solution Explorer and select Properties.

   2. Select Configuration Properties > General and Advanced.
      
      Ensure that the properties on those two tabs are configured as:

      • Output Directory: $(SolutionDir)$(Platform)\$(Configuration)\

      • Configuration Type: Dynamic Library (.dll)

      • Use of MFC: Use MFC in a Shared DLL

      • Character Set: Use Unicode Character Set

   3. Select Linker > General.
      
      Ensure Output File is:

      •  $(SolutionDir)$(Platform)\$(Configuration)\$(TargetName)$(TargetExt)

   4. Select Linker > Input.
      
      Ensure that Module Definition File is .\project_name.def.

   5. Select Linker > Embedded IDL.
      
      Ensure the properties are configured as follows:

      • Type Library: $(SolutionDir)$(Platform)\$(Configuration)\$(ProjectName).tlb

      • TypeLib Resource ID should be empty. Delete any characters appearing in this row.

   6. Select MIDL > General.
      
      Select the environment in the Target Environment dropdown that most closely matches your environment.

   7. Select MIDL > Output.
      
      Ensure the properties are configured as follows:

      • Output Directory: $(SolutionDir)$(Platform)\$(Configuration)\

      • Type Library: $(IntDir)project_name.tlb

6. Click OK.

7. To change the project's type of configuration to Release:

   1. In the Solution Explorer, right-click Solution 'project_name' and select Configuration Manager.

   2. Click the down-arrow key in the project's Configuration column and select Release.

   3. Click Close.

8. Save the project. Compile the project for x64 to create and register an add-in DLL that is compatible with your system.
   
   NOTE: See Using .NET Framework in Add-in Applications if a problem occurs at runtime.
    

9. Add the new add-in, project_name.dll, to the file vault:
    

   1. Start up the SOLIDWORKS PDM Professional Administration tool as Administrator.
       
   2. Expand the vault where you want to install this add-in. Log in, if prompted.
       
   3. Right-click Add-ins and select New Add-in.
       
   4. Select:
       
      • If x32: project_path\project_name\Release\project_name.dll, and click Open.
         
      • If x64: project_path\project_name\x64\Release\project_name.dll, and click Open.
        
        The add-in Properties dialog displays the add-in's name, company, add-in version, required version of SOLIDWORKS PDM Professional, package, and description.
         
   5. Click OK.

    

10. Right-click the vault directory in File Explorer to show the context menu:
    
    
    The new menu item, "My first menu command", appears in the context menu.
     

11. Select My first menu command on the context-sensitive menu.
     

12. A message box is displayed.
    

Use your new add-in to create more advanced menu commands or add-in hooks that allow you to check files in and out of the vault.

If you experience difficulties compiling the C++ add-in after following all the steps outlined above, you should submit a service request using the API Support App. An API Support Engineer can provide you with assistance.