서버 등록 전역 함수
이러한 함수는 개체 맵에서 서버 개체 등록 및 등록 취소를 지원합니다.
Important
다음 표에 나열된 함수는 Windows 런타임 실행되는 애플리케이션에서 사용할 수 없습니다.
| 속성 | 설명 |
|---|---|
| AtlComModuleRegisterServer | 이 함수는 개체 맵의 모든 개체를 등록하기 위해 호출됩니다. |
| AtlComModuleUnregisterServer | 이 함수는 개체 맵의 모든 개체를 등록 취소하기 위해 호출됩니다. |
| AtlComModuleRegisterClassObjects | 이 함수는 클래스 개체를 등록하기 위해 호출됩니다. |
| AtlComModuleRevokeClassObjects | 이 함수는 COM 모듈에서 클래스 개체를 해지하기 위해 호출됩니다. |
| AtlComModuleGetClassObject | 이 함수는 클래스 개체를 가져오기 위해 호출됩니다. |
요구 사항
헤더: atlbase.h
AtlComModuleRegisterServer
이 함수는 개체 맵의 모든 개체를 등록하기 위해 호출됩니다.
ATLINLINE ATLAPI AtlComModuleRegisterServer(
_ATL_COM_MODULE* pComModule,
BOOL bRegTypeLib,
const CLSID* pCLSID);
매개 변수
pComModule
COM 모듈에 대한 포인터입니다.
bRegTypeLib
형식 라이브러리를 등록하려면 TRUE입니다.
pCLSID
등록할 개체의 CLSID를 가리킵니다. NULL이면 개체 맵의 모든 개체가 등록됩니다.
Return Value
성공 시 S_OK를 반환하거나 실패 시 HRESULT 오류를 반환합니다.
설명
AtlComModuleRegisterServer 는 ATL 자동 생성된 개체 맵을 탐색하고 각 개체를 맵에 등록합니다. pCLSID가 NULL이 아니면 pCLSID에서 참조하는 개체만 등록되고, 그렇지 않으면 모든 개체가 등록됩니다.
이 함수는 CAtlComModule::RegisterServer에 의해 호출됩니다.
AtlComModuleUnregisterServer
이 함수는 개체 맵의 모든 개체를 등록 취소하기 위해 호출됩니다.
ATLINLINE ATLAPI AtlComModuleUnregisterServer(
_ATL_COM_MODULE* pComModule,
BOOL bUnRegTypeLib,
const CLSID* pCLSID);
매개 변수
pComModule
COM 모듈에 대한 포인터입니다.
bUnRegTypeLib
형식 라이브러리를 등록하려면 TRUE입니다.
pCLSID
등록 취소할 개체의 CLSID를 가리킵니다. NULL이면 개체 맵의 모든 개체가 등록 취소됩니다.
Return Value
성공 시 S_OK를 반환하거나 실패 시 HRESULT 오류를 반환합니다.
설명
AtlComModuleUnregisterServer 는 ATL 개체 맵을 탐색하고 지도의 각 개체의 등록을 취소합니다. pCLSID가 NULL이 아니면 pCLSID에서 참조하는 개체만 등록 취소되고, 그렇지 않으면 모든 개체가 등록 취소됩니다.
이 함수는 CAtlComModule::UnregisterServer에 의해 호출됩니다.
AtlComModuleRegisterClassObjects
이 함수는 클래스 개체를 등록하기 위해 호출됩니다.
ATLINLINE ATLAPI AtlComModuleRegisterClassObjects(
_ATL_COM_MODULE* pComModule,
DWORD dwClsContext,
DWORD dwFlags);
매개 변수
pComModule
COM 모듈에 대한 포인터입니다.
dwClsContext
클래스 개체를 실행할 컨텍스트를 지정합니다. 가능한 값은 CLSCTX_INPROC_SERVER, CLSCTX_INPROC_HANDLER 또는 CLSCTX_LOCAL_SERVER. 자세한 내용은 CLSCTX를 참조하세요.
dwFlags
클래스 개체에 대한 연결 형식을 결정합니다. 가능한 값은 REGCLS_SINGLEUSE, REGCLS_MULTIPLEUSE 또는 REGCLS_MULTI_SEPARATE. 자세한 내용은 REGCLS를 참조하세요.
Return Value
성공 시 S_OK를 반환하거나 실패 시 HRESULT 오류를 반환합니다.
설명
이 도우미 함수는 CComModule::RegisterClassObjects(ATL 7.0에서는 사용되지 않음) 및 CAtlExeModuleT::RegisterClassObjects에서 사용됩니다.
AtlComModuleRevokeClassObjects
이 함수는 실행 개체 테이블에서 클래스 팩터리를 제거하기 위해 호출됩니다.
ATLINLINE ATLAPI AtlComModuleRevokeClassObjects(_ATL_COM_MODULE* pComModule);
매개 변수
pComModule
COM 모듈에 대한 포인터입니다.
Return Value
성공 시 S_OK를 반환하거나 실패 시 HRESULT 오류를 반환합니다.
설명
이 도우미 함수는 CComModule::RevokeClassObjects(ATL 7.0에서는 사용되지 않음) 및 CAtlExeModuleT::RevokeClassObjects에서 사용됩니다.
AtlComModuleGetClassObject
이 함수는 클래스 팩터리를 반환하기 위해 호출됩니다.
ATLINLINE ATLAPI AtlComModuleGetClassObject(
_ATL_COM_MODULE* pComModule,
REFCLSID rclsid,
REFIID riid,
LPVOID* ppv);
매개 변수
pComModule
COM 모듈에 대한 포인터입니다.
rclsid
만들 개체의 CLSID입니다.
riid
요청된 인터페이스의 IID입니다.
ppv
riid로 식별되는 인터페이스 포인터에 대한 포인터입니다. 개체가 이 인터페이스 를 지원하지 않는 경우 ppv 는 NULL로 설정됩니다.
Return Value
성공 시 S_OK를 반환하거나 실패 시 HRESULT 오류를 반환합니다.
설명
이 도우미 함수는 CComModule::GetClassObject(ATL 7.0에서는 사용되지 않음) 및 CAtlDllModuleT::GetClassObject에서 사용됩니다.