The RPC_IF_HANDLE data type declares an interface handle.

typedef void __RPC_FAR* RPC_IF_HANDLE;


The RPC run-time library uses interface handles to access the interface-specification data structure. The MIDL compiler automatically creates an interface-specification data structure from each IDL file and creates a global variable of type RPC_IF_HANDLE for the interface specification.

The MIDL compiler includes an interface handle in each header file generated for the interface. Functions requiring the interface specification as a parameter show a data type of RPC_IF_HANDLE. The form of each interface handle name is as follows:

  • if-name_ClientIfHandle (for the client)
  • if-name_ServerIfHandle (for the server)

The if-name part specifies the interface identifier in the IDL file.

For example:



Note  The maximum length of the interface handle name is 31 characters.

Because the "_ClientIfHandle" and "_ServerIfHandle" parts of the names require 15 characters, the if-name element can be no more than 16 characters long.


Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]


Rpcdce.h (include Rpc.h)