RPC_IF_HANDLE
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:
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.
Requirement | Value |
---|---|
Minimum supported client |
Windows 2000 Professional [desktop apps only] |
Minimum supported server |
Windows 2000 Server [desktop apps only] |
Header |
|