AtlModuleUnregisterServerEx

Article
12/01/2015

Unregisters every object in the object map.

Note This function is obsolete in Visual C++ .NET 2002 and later but is available for backward compatibility with projects created with previous versions of Visual C++.

Syntax

      ATLAPI AtlModuleUnregisterServerEx(
   _ATL_MODULE* pM,
   BOOL bUnRegTypeLib,
   const CLSID* pCLSID 
);

Parameters

pM
Pointer to a CComModule class or derived class.
bUnRegTypeLib
TRUE if the type library is to be registered.
pCLSID
Points to the CLSID of the object to be unregistered. If NULL, all objects in the object map will be unregistered.

Return Value

Returns S_OK on success, or an error HRESULT on failure.

Remarks

This function walks the ATL object map and unregisters each object in the map. If pCLSID is not NULL, then only the object referred to by pCLSID is unregistered; otherwise all of the objects are unregistered.

This function is obsolete. Instead, use its replacement, AtlComModuleUnregisterServer.

This helper function is used by CComModule::UnregisterServer.

Requirements

Header: atlbase.h

Share via