AcDbHostApplicationServices::registerMapFileCallback

C++

virtual ACDBCORE2D_PORT Acad::ErrorStatus registerMapFileCallback(
    const ACHAR * appName, 
    REMAPPROC proc, 
    bool unRegister = false, 
    bool asPrimary = false
);

Description

This function allows you to register a callback function to map a file. An application can register as either primary or secondary client. To prevent conflict between different applications overriding the file mapping, the primary client is called first. Based on information passed into the callback procedure, the primary client can either handle the request or decline. If it's handled, there's no further call to other clients. If it's declined, the next client will be called and the same rule applies. If no application handles it, then the host application, just proceeds with the file it has and it is not mapped to anything else.

The file name string returned as the first argument from the callback function must be dynamically allocated. The preferred allocation method is acutNewString().

Parameters

Links

AcDbHostApplicationServices