RpcServerInterfaceGroupActivate-Funktion (rpcdce.h)

  • Artikel

Die RpcServerInterfaceGroupActivate-Funktion weist die RPC-Serverlaufzeit an, die Schnittstellen und Endpunkte der Schnittstellengruppe zu registrieren und mit dem Lauschen auf Aufrufe zu beginnen.

Syntax

RPC_STATUS RpcServerInterfaceGroupActivate(
  [in] RPC_INTERFACE_GROUP IfGroup
);

Parameter

[in] IfGroup

Ein RPC_INTERFACE_GROUP von RpcServerInterfaceGroupCreate , der die zu aktivierende Schnittstellengruppe definiert.

Rückgabewert

Wert Bedeutung
RPC_S_OK
 Der Aufruf war erfolgreich.
RPC_S_PROTSEQ_NOT_SUPPORTED
 Die Protokollsequenz wird auf diesem Host nicht unterstützt.
RPC_S_INVALID_RPC_PROTSEQ
 Die Protokollsequenz ist ungültig.
RPC_S_INVALID_ENDPOINT_FORMAT
 Das Endpunktformat ist ungültig.
RPC_S_OUT_OF_MEMORY
 Das System hat nicht genügend Arbeitsspeicher.
RPC_S_INVALID_SECURITY_DESC
 Die Sicherheitsbeschreibung für einen Endpunkt oder eine Schnittstelle ist ungültig.
 
Hinweis Eine Liste der gültigen Fehlercodes finden Sie unter RPC-Rückgabewerte.
 

Hinweise

RpcServerInterfaceGroupActivate übernimmt den Großteil der Initialisierungsarbeiten, die die RPC-Serveranwendungen ausführen müssen. Es führt die folgenden Vorgänge aus:

  • Weist die RPC-Runtime an, mit dem Lauschen auf Anrufe zu beginnen.
  • Registriert die Endpunkte bei der Serverlaufzeit.
  • Registriert die Schnittstellen bei der Serverlaufzeit.
  • Registriert die Endpunkte und Schnittstellen beim RPC-Endpunktzuordnungs-Mapper.

RpcServerInterfaceGroupActivate ist atomisch. Wenn der Vorgang zu irgendeinem Zeitpunkt fehlschlägt, werden alle zuvor registrierten Elemente rückgängiggemacht.

Aufrufe können an die Serveranwendung weitergeleitet werden, bevor diese Funktion zurückgegeben wird.

Anforderungen

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

Weitere Informationen

RpcServerInterfaceGroupClose

RpcServerInterfaceGroupCreate

RpcServerInterfaceGroupAktivieren

RpcServerInterfaceGroupInqBindings