RpcServerRegisterIf-Funktion (rpcdce.h)

Artikel
03/04/2024

Die RpcServerRegisterIf-Funktion registriert eine Schnittstelle bei der RPC-Laufzeitbibliothek.

Syntax

RPC_STATUS RpcServerRegisterIf(
  RPC_IF_HANDLE IfSpec,
  UUID          *MgrTypeUuid,
  RPC_MGR_EPV   *MgrEpv
);

Parameter

IfSpec

MIDL-generierte Struktur, die die zu registrierende Schnittstelle angibt.

MgrTypeUuid

Zeiger auf eine Typ-UUID, die dem MgrEpv-Parameter zugeordnet werden soll. Wenn Sie einen NULL-Parameterwert (oder eine Null-UUID) angeben, wird IfSpec mit einer UUID vom Typ nil registriert.

MgrEpv

Einstiegspunktvektor (EPV) von Managerroutinen. Um die von MIDL generierte Standard-EPV zu verwenden, geben Sie einen NULL-Wert an. Weitere Informationen finden Sie unter RPC_MGR_EPV.

Rückgabewert

Gibt bei Erfolg RPC_S_OK zurück.

Hinweis Eine Liste der gültigen Fehlercodes finden Sie unter RPC-Rückgabewerte.

Hinweise

Ein Server kann eine unbegrenzte Anzahl von Schnittstellen bei der RPC-Laufzeitbibliothek registrieren. Die Registrierung stellt eine Schnittstelle für Clients zur Verfügung, die ein Bindungshandle für den Server verwenden. Um eine Schnittstelle zu registrieren, ruft der Serveranwendungscode RpcServerRegisterIf auf. Für jede Implementierung einer Schnittstelle, die ein Server anbietet, muss ein separates Manager-EPV registriert werden.

Beim Aufrufen von RpcServerRegisterIf stellt der Server die folgenden Informationen bereit:

Schnittstellenspezifikation
Die Schnittstellenspezifikation ist eine Datenstruktur, die vom MIDL-Compiler generiert wird. Der Server gibt die Schnittstelle mithilfe des IfSpec-Parameters an.
Managertyp UUID und Manager-EPV
Der Managertyp UUID und der Manager-EPV bestimmen, welche Managerroutine ausgeführt wird, wenn ein Server eine Remoteprozeduraufrufanforderung von einem Client empfängt.

Der Server gibt den Managertyp UUID und EPV mit den Parametern MgrTypeUuid und MgrEpv an. Beachten Sie, dass der Server beim Angeben einer Nicht-Nil-Manager-UUID auch die RpcObjectSetType-Funktion aufrufen muss, um Objekte dieses Nicht-Null-Typs zu registrieren.

Wenn Ihre Serveranwendung eine Schnittstelle zum automatischen Lauschen registrieren oder eine Rückruffunktion zu Authentifizierungszwecken verwenden muss, verwenden Sie RpcServerRegisterIfEx.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	rpcdce.h (include Rpc.h)
Bibliothek	Rpcrt4.lib
DLL	Rpcrt4.dll