RPC_IF_HANDLE

The RPC_IF_HANDLE data type declares an interface handle.

typedef void __RPC_FAR* RPC_IF_HANDLE;

Remarks

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:

hello_ClientIfHandle

hello_ServerIfHandle

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.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Header	Rpcdce.h (include Rpc.h)