ArcGIS Engine Developer Guide

VISUAL C++
}
return _Module.UnregisterServer(TRUE);
ATL provides a text file format, .rgs, that is parsed by the ATL’s registrar component
when a DLL is registered and unregistered. The .rgs file is built into a DLL
as a custom resource. The file can be edited to add additional registry entries and
contains ProgID, ClassID, and component category entries. The syntax describes
keys, values, names, and subkeys to be added to or removed from the registry. The
format can be summarized as follows:
[NoRemove | ForceRemove | val] Name | [ = s 'Value' | d 'Value' | b 'Value' ]
{
.. optional subkeys for the registry
}
NoRemove signifies that the registry key should not be removed on unregistration.
ForceRemove will ensure the key and subkeys are removed before registering the
new keys. The s, d, and b values indicate string (enclosed with apostrophes),
double word (32-bit integer value), and binary registry values. A typical registration
script is shown below.
HKCR
{
SimpleObject.SimpleCOMObject.1 = s 'SimpleCOMObject Class'
{
CLSID = s '{2AFFC10E-ECFB-4697-8B3D-0405650B7CFB}'
}
SimpleObject.SimpleCOMObject = s 'SimpleCOMObject Class'
{
CLSID = s '{2AFFC10E-ECFB-4697-8B3D-0405650B7CFB}'
CurVer = s 'SimpleObject.SimpleCOMObject.1'
}
NoRemove CLSID
{
ForceRemove {2AFFC10E-ECFB-4697-8B3D-0405650B7CFB} = s 'SimpleCOMObject
Class'
{
ProgID = s 'SimpleObject.SimpleCOMObject.1'
VersionIndependentProgID = s 'SimpleObject.SimpleCOMObject'
InprocServer32 = s '%MODULE%'
{
val ThreadingModel = s 'Apartment'
}
'TypeLib' = s '{855DD226-5938-489D-986E-149600FEDD63}'
'Implemented Categories'
{
{7DD95801-9882-11CF-9FA9-00AA006C42C4}
}
}
}
}
NoRemove CLSID ensures the registry key CLSID is never removed. This is the
subkey that all COM objects use to register their ProgIDs and GUIDs, so its
Chapter 4 • Developer environments • 103