다음을 통해 공유


DeactivateActCtx 함수(winbase.h)

DeactivateActCtx 함수는 지정된 쿠키에 해당하는 활성화 컨텍스트를 비활성화합니다.

구문

BOOL DeactivateActCtx(
  [in] DWORD     dwFlags,
  [in] ULONG_PTR ulCookie
);

매개 변수

[in] dwFlags

비활성화가 발생하는 방식을 나타내는 플래그입니다.

의미
0
이 값이 설정되고 ulCookie 매개 변수에 지정된 쿠키가 활성화 스택의 위쪽 프레임에 있으면 활성화 컨텍스트가 스택에서 팝업되어 비활성화됩니다.

이 값이 설정되고 ulCookie 매개 변수에 지정된 쿠키가 활성화 스택의 위쪽 프레임에 없는 경우 이 함수는 스택에서 쿠키를 검색합니다.

쿠키가 발견되면 STATUS_SXS_EARLY_DEACTIVATION 예외가 throw됩니다.

쿠키를 찾을 수 없으면 STATUS_SXS_INVALID_DEACTIVATION 예외가 throw됩니다.

이 값은 대부분의 경우 지정해야 합니다.

DEACTIVATE_ACTCTX_FLAG_FORCE_EARLY_DEACTIVATION
이 값이 설정되고 ulCookie 매개 변수에 지정된 쿠키가 활성화 스택의 위쪽 프레임에 있는 경우 함수는 ERROR_INVALID_PARAMETER 오류 코드를 반환합니다. GetLastError를 호출하여 이 코드를 가져옵니다.

이 값이 설정되고 쿠키가 활성화 스택에 없는 경우 STATUS_SXS_INVALID_DEACTIVATION 예외가 throw됩니다.

이 값이 설정되고 쿠키가 활성화 스택의 아래쪽 프레임에 있는 경우 쿠키가 있는 프레임까지의 모든 프레임이 스택에서 팝됩니다.

[in] ulCookie

ActivateActCtx 호출에 전달된 ULONG_PTR. 이 값은 특정 활성화된 활성화 컨텍스트를 식별하는 쿠키로 사용됩니다.

반환 값

함수가 성공하면 TRUE를 반환합니다. 그렇지 않으면 FALSE를 반환합니다.

이 함수는 GetLastError를 호출하여 검색할 수 있는 오류를 설정합니다. 예제는 Last-Error 코드 검색을 참조하세요. 오류 코드의 전체 목록은 시스템 오류 코드를 참조하세요.

설명

활성화 컨텍스트의 비활성화는 활성화의 역순으로 발생해야 합니다. 스택에서 활성화 컨텍스트를 터지는 것으로 이해할 수 있습니다.

요구 사항

   
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 winbase.h(Windows.h 포함)
라이브러리 Kernel32.lib
DLL Kernel32.dll

참고 항목

ActivateActCtx