Freigeben über


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
Rpcdce.h (rpc.h einschließen)