FIX: RpcTestCancel() Always Returns Error Code 5 (192127)



The information in this article applies to:

  • Microsoft Windows NT Server 4.0 Terminal Server Edition
  • Microsoft Windows NT Server 4.0
  • Microsoft Windows NT Workstation 4.0

This article was previously published under Q192127

SYMPTOMS

Your RPC server manager routine makes a RpcTestCancel() call to test if the current RPC call has been cancelled by the remote RPC client. However, this call always returns error code 5.

RESOLUTION

To resolve this problem, obtain the latest service pack for Windows NT 4.0 or Windows NT Server 4.0, Terminal Server Edition. For additional information, click the following article number to view the article in the Microsoft Knowledge Base:

152734 How to Obtain the Latest Windows NT 4.0 Service Pack


STATUS

Microsoft has confirmed that this is a problem in Windows NT 4.0 and Windows NT Server 4.0, Terminal Server Edition. This problem was first corrected in Windows NT 4.0 Service Pack 4.0 and Windows NT Server 4.0, Terminal Server Edition Service Pack 4.

MORE INFORMATION

Under Windows NT version 4.0 Service Pack 3 and previous Service Packs, when an RPC client issues a cancel then the client is unblocked. However, the server never notices the cancel. If the client is using an infinite timeout, the client does not unblock unless the server finishes or fails the call.

On Windows NT version 4.0, you need to do the following to cancel an RPC remote call:

  1. Use connection-oriented protocols, such as ncacn_ip_tcp, for communication between your RPC client and server.
  2. In the client-side main thread start another call thread to make the actual RPC call. For example: CallThread = (void *) _beginthreadex(...);
  3. The call thread issues RpcMgmtSetCancelTimeout(0), where 0 indicates that you do not want to wait for the RPC server to acknowledge the cancel (the call is immediately abandoned upon a cancel). Next, your call thread makes the actual RPC call.
  4. In the main thread, you can either call Sleep() to sleep for sometime or wait until the timeout expired and issue RpcCancelThread() to cancel the call if it timeouts. For example: rc = WaitForSingleObject(CallThread, 5000); if (WAIT_TIMEOUT == rc) { status = RpcCancelThread(CallThread); . . .
  5. In your RPC server-side manager routine, you need to test if the current RPC call has been cancelled by calling RpcTestCancel(). However, RpcTestCancel() always returns error code 5, even if the cancel packet has been received by the RPC server runtime.

Modification Type:MajorLast Reviewed:6/28/2004
Keywords:kbbug kbfix kbnetwork kbRPC KB192127