AcMapDMDisplayManagement::GetGWS Function

This function opens the GWS that the map refers to.

Acad::ErrorStatus GetGWS(
    IGWS** pGWS, 
    AcDbDatabase* pDb
);

DmDisplayManagement.h

Returns Acad::eOk if successful, Acad::eKeyNotFound if the dictionary entry with the file name does not exist otherwise, returns a different error code.

If the GWS does not exist yet it will create it and assign it to the Map. Once it has been created the name of the XML file is stored in the dictionary; this function retrieves the name from the dictionary to nopen the GWS.