如何获取已启动CATIA会话中已打开的CATDocument指针

问题描述 #

已成功获取活跃CATIA会话的CATIAApplication对象指针，但通过get_ActiveDocument拿到的CATIADocument无法直接转换为CATDocument以处理产品结构。尝试通过文档路径调用CATDocumentServices::Open重新打开时，产品会被加载到无界面的幽灵会话中，无法关联到当前交互会话；尝试CATDocumentServices、CATSessionServices及CATSession相关方法均未解决问题。

现有代码 #

CLSID clsid;
HRESULT hr = CLSIDFromProgID(L"CATIA.Application", &clsid);
CComPtr<IUnknown> pCatiaSession;
hr = GetActiveObject(clsid, NULL, &pCatiaSession);
CATIAApplication * pApp = NULL;
// 注：原代码变量名错误，应为pCatiaSession而非pSession
hr = pCatiaSession->QueryInterface(IID_CATIAApplication, (void**) &pApp);
CATIADocument * pDocument = NULL;
hr = pApp->get_ActiveDocument(pDocument);

解决方案 #

通过自动化接口获取的CATIADocument需转换为CAA框架下的CATDocument对象，核心是利用CATDocumentServices::GetDocument方法关联当前会话中的活跃文档，而非重新打开。具体代码如下：

// 确保已成功获取CATIAApplication* pApp和CATIADocument* pAutomationDoc
IDispatch* pDispatch = nullptr;
HRESULT hr = pAutomationDoc->QueryInterface(IID_IDispatch, (void**)&pDispatch);
if (SUCCEEDED(hr) && pDispatch)
{
    CATDocument* pDoc = nullptr;
    hr = CATDocumentServices::GetDocument(pDispatch, &pDoc);
    if (SUCCEEDED(hr) && pDoc)
    {
        // 转换为CATProduct以处理产品结构
        CATProduct* pProduct = nullptr;
        hr = pDoc->QueryInterface(IID_CATProduct, (void**)&pProduct);
        if (SUCCEEDED(hr) && pProduct)
        {
            // 在此处编写产品结构处理逻辑
            // ...
            
            pProduct->Release();
        }
        pDoc->Release();
    }
    pDispatch->Release();
}

关键说明 #

1. 避免重新打开文档：CATDocumentServices::Open默认会创建独立的无界面会话，无法关联到当前用户交互的CATIA会话，因此必须通过现有自动化文档对象直接转换。
2. COM对象释放：所有通过QueryInterface获取的指针需在使用完成后调用Release()，避免内存泄漏。
3. 变量名修正：原代码中存在变量名错误（pSession应为pCatiaSession），需先修正该问题确保接口获取正常。

内容的提问来源于stack exchange，提问作者Nicolas Chevalier