Freigeben über


RpcServerRegisterIf-Funktion (rpcdce.h)

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

Weitere Informationen

Registrieren von Schnittstellen

RpcBindingFromStringBinding

RpcBindingSetObject

RpcNsBindingExport

RpcNsBindingImportBegin

RpcNsBindingLookupBegin

RpcObjectSetType

RpcServerRegisterIf2

RpcServerRegisterIf3

RpcServerRegisterIfEx

RpcServerUnregisterIf

RpcServerUnregisterIfEx