CoGetApartmentType 함수(combaseapi.h)

  • 아티클

현재 아파트 형식 및 형식 한정자를 반환합니다.

구문

HRESULT CoGetApartmentType(
  [out] APTTYPE          *pAptType,
  [out] APTTYPEQUALIFIER *pAptQualifier
);

매개 변수

[out] pAptType

현재 아파트의 형식을 지정하는 APTTYPE 열거형 값입니다.

[out] pAptQualifier

현재 아파트의 형식 한정자를 지정하는 APTTYPEQUALIFIER 열거형 값입니다.

반환 값

호출이 성공하면 S_OK 반환합니다. 그렇지 않으면 다음 오류 코드 중 하나가 반환됩니다.

반환 코드 설명
E_FAIL
 호출이 현재 아파트 유형 및 형식 한정자를 쿼리할 수 없습니다.
E_INVALIDARG
 잘못된 매개 변수 값이 함수에 제공되었습니다. 특히 호출자가 매개 변수 중 하나 또는 둘 다를 NULL 로 설정했습니다.
CO_E_NOTINITIALIZED

CoGetApartmentType을 호출하기 전에 이 스레드에서 CoInitialize 또는 CoInitializeEx가 호출되지 않았습니다.

설명

Windows 7 이전의 Windows 플랫폼에서는 스레드에서 다음 작업을 수행하여 아파트 유형을 쿼리해야 합니다.

다중 스레드 시나리오에서는 위의 작업 시퀀스를 실행할 때 프로세스 내에서 액세스 위반이 발생할 수 있는 경합 조건이 있습니다. CoGetApartmentType 함수는 액세스 위반이 발생할 가능성이 없으므로 권장됩니다.

요구 사항

   
지원되는 최소 클라이언트 Windows 7 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2008 R2 [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 combaseapi.h(Objbase.h 포함)
라이브러리 Ole32.lib
DLL Ole32.dll

추가 정보

APTTYPE

APTTYPEQUALIFIER