RPC _ IF _ HANDLE

Der RPC _ IF _ HANDLE-Datentyp deklariert ein Schnittstellenhandle.

typedef void __RPC_FAR* RPC_IF_HANDLE;

Hinweise

Die RPC-Laufzeitbibliothek verwendet Schnittstellenhandles, um auf die Datenstruktur der Schnittstellenspezifikation zuzugreifen. Der MIDL-Compiler erstellt automatisch eine Schnittstellenspezifikations-Datenstruktur aus jeder IDL-Datei und 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 jedes Schnittstellenhandlenamens 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.

Zum Beispiel:

hello _ ClientIfHandle

hello _ ServerIfHandle

Hinweis

Die maximale Länge des Schnittstellenhandlenamens beträgt 31 Zeichen.

Da die _ Teile "ClientIfHandle" und _ "ServerIfHandle" 15 Zeichen benötigen, 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
Rpcdce.h (include Rpc.h)