RpcServerInterfaceGroupActivate-Funktion (rpcdce.h)
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 |
|---|---|
|
Der Aufruf war erfolgreich. |
|
Die Protokollsequenz wird auf diesem Host nicht unterstützt. |
|
Die Protokollsequenz ist ungültig. |
|
Das Endpunktformat ist ungültig. |
|
Das System hat nicht genügend Arbeitsspeicher. |
|
Die Sicherheitsbeschreibung für einen Endpunkt oder eine Schnittstelle ist ungültig. |
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 |