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 표준 반환 값과 다음 값을 반환할 수 있습니다.
반환 코드 | 설명 |
---|---|
|
취소 요청이 이루어졌습니다. |
|
지정된 스레드에 해당하는 취소 개체가 없습니다. |
|
호출 취소는 지정된 스레드에서 사용할 수 없습니다. |
|
시간 제한 간격 동안 호출이 완료되었습니다. |
|
호출이 이미 취소되었습니다. |
설명
CoCancelCall은 실행 중인 호출에 대해 취소 개체에서 CoGetCancelObject 를 호출한 다음 ICancelMethodCalls::Cancel 을 호출합니다.
이 함수는 비동기 호출에 대한 취소 개체를 찾지 않습니다.
개체 서버는 CoTestCancel을 주기적으로 호출하여 호출이 취소되었는지 확인할 수 있습니다. 호출이 취소된 경우 개체 서버가 클린 컨트롤을 클라이언트로 반환해야 합니다.
요구 사항
지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
대상 플랫폼 | Windows |
헤더 | combaseapi.h(Objbase.h 포함) |
라이브러리 | Ole32.lib |
DLL | Ole32.dll |