CoGetApartmentType 함수(combaseapi.h)
현재 아파트 형식 및 형식 한정자를 반환합니다.
구문
HRESULT CoGetApartmentType(
[out] APTTYPE *pAptType,
[out] APTTYPEQUALIFIER *pAptQualifier
);
매개 변수
[out] pAptType
현재 아파트의 형식을 지정하는 APTTYPE 열거형 값입니다.
[out] pAptQualifier
현재 아파트의 형식 한정자를 지정하는 APTTYPEQUALIFIER 열거형 값입니다.
반환 값
호출이 성공하면 S_OK 반환합니다. 그렇지 않으면 다음 오류 코드 중 하나가 반환됩니다.
| 반환 코드 | 설명 |
|---|---|
|
호출이 현재 아파트 유형 및 형식 한정자를 쿼리할 수 없습니다. |
|
잘못된 매개 변수 값이 함수에 제공되었습니다. 특히 호출자가 매개 변수 중 하나 또는 둘 다를 NULL 로 설정했습니다. |
|
CoGetApartmentType을 호출하기 전에 이 스레드에서 CoInitialize 또는 CoInitializeEx가 호출되지 않았습니다. |
설명
Windows 7 이전의 Windows 플랫폼에서는 스레드에서 다음 작업을 수행하여 아파트 유형을 쿼리해야 합니다.
- CoGetContextToken을 호출하여 현재 컨텍스트 토큰을 가져옵니다.
- 컨텍스트 토큰을 IUnknown* 포인터로 캐스팅합니다.
- 해당 포인터에서 QueryInterface 메서드를 호출하여 IComThreadingInfo 인터페이스를 가져옵니다.
- IComThreadingInfo 인터페이스의 GetCurrentApartmentType 메서드를 호출하여 현재 아파트 형식을 가져옵니다.
다중 스레드 시나리오에서는 위의 작업 시퀀스를 실행할 때 프로세스 내에서 액세스 위반이 발생할 수 있는 경합 조건이 있습니다. CoGetApartmentType 함수는 액세스 위반이 발생할 가능성이 없으므로 권장됩니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 7 [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows Server 2008 R2 [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | combaseapi.h(Objbase.h 포함) |
| 라이브러리 | Ole32.lib |
| DLL | Ole32.dll |