CoCancelCall 함수(combaseapi.h)

  • 아티클

지정된 스레드에서 보류 중인 아웃바운드 DCOM 메서드 호출의 취소를 요청합니다.

구문

HRESULT CoCancelCall(
  [in] DWORD dwThreadId,
  [in] ULONG ulTimeout
);

매개 변수

[in] dwThreadId

보류 중인 DCOM 호출을 취소할 스레드의 식별자입니다. 이 매개 변수가 0이면 호출이 현재 스레드에 있습니다.

[in] ulTimeout

CoCancelCall은 클라이언트가 취소를 요청한 후 서버가 아웃바운드 호출을 완료할 때까지 대기하는 시간(초)입니다.

반환 값

이 함수는 E_FAIL, E_OUTOFMEMORY 및 E_UNEXPECTED 표준 반환 값과 다음 값을 반환할 수 있습니다.

반환 코드 설명
S_OK
 취소 요청이 이루어졌습니다.
E_NOINTERFACE
 지정된 스레드에 해당하는 취소 개체가 없습니다.
CO_E_CANCEL_DISABLED
 호출 취소는 지정된 스레드에서 사용할 수 없습니다.
RPC_E_CALL_COMPLETE
 시간 제한 간격 동안 호출이 완료되었습니다.
RPC_E_CALL_CANCELED
 호출이 이미 취소되었습니다.

설명

CoCancelCall은 실행 중인 호출에 대해 취소 개체에서 CoGetCancelObject 를 호출한 다음 ICancelMethodCalls::Cancel 을 호출합니다.

이 함수는 비동기 호출에 대한 취소 개체를 찾지 않습니다.

개체 서버는 CoTestCancel을 주기적으로 호출하여 호출이 취소되었는지 확인할 수 있습니다. 호출이 취소된 경우 개체 서버가 클린 컨트롤을 클라이언트로 반환해야 합니다.

요구 사항

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

추가 정보

CoTestCancel