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

값

의미

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

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

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

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

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

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

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

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

[in] ulCookie

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

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

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

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