RPC_IF_HANDLE
Der datentyp RPC_IF_HANDLE deklariert ein Schnittstellenhandle.
typedef void __RPC_FAR* RPC_IF_HANDLE;
Bemerkungen
Die RPC-Laufzeitbibliothek verwendet Schnittstellenhandles, um auf die Datenstruktur der Schnittstellenspezifikation zuzugreifen. Der MIDL-Compiler erstellt automatisch eine Datenstruktur der Schnittstellenspezifikation aus jeder IDL-Datei und erstellt eine globale Variable vom Typ RPC_IF_HANDLE für die Schnittstellenspezifikation.
Der MIDL-Compiler enthält ein Schnittstellenhandle in jeder Headerdatei, die für die Schnittstelle generiert wird. Funktionen, die die Schnittstellenspezifikation als Parameter erfordern, zeigen den Datentyp RPC_IF_HANDLE an. Die Form der einzelnen Schnittstellenhandles lautet wie folgt:
- if-name_ClientIfHandle (für den Client)
- if-name_ServerIfHandle (für den Server)
Der If-Name-Teil gibt den Schnittstellenbezeichner in der IDL-Datei an.
Beispiel:
hello_ClientIfHandle
hello_ServerIfHandle
Hinweis
Die maximale Länge des Schnittstellenhandles-Namens beträgt 31 Zeichen.
Da die Teile "_ClientIfHandle" und "_ServerIfHandle" der Namen 15 Zeichen erfordern, darf das If-Name-Element maximal 16 Zeichen lang sein.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
| Header |
|