RpcServerInterfaceGroupActivate, fonction (rpcdce.h)
La fonction RpcServerInterfaceGroupActivate indique au runtime du serveur RPC d’inscrire les interfaces et les points de terminaison du groupe d’interfaces et de commencer à écouter les appels.
Syntaxe
RPC_STATUS RpcServerInterfaceGroupActivate(
[in] RPC_INTERFACE_GROUP IfGroup
);
Paramètres
[in] IfGroup
Une RPC_INTERFACE_GROUP de RpcServerInterfaceGroupCreate qui définit le groupe d’interfaces à activer.
Valeur retournée
| Valeur | Signification |
|---|---|
|
L’appel a réussi. |
|
La séquence de protocole n’est pas prise en charge sur cet hôte. |
|
La séquence de protocole n’est pas valide. |
|
Format du point de terminaison non valide. |
|
Le système est en mémoire insuffisante. |
|
Le descripteur de sécurité d’un point de terminaison ou d’une interface n’est pas valide. |
Note Pour obtenir la liste des codes d’erreur valides, consultez Valeurs de retour RPC.
Remarques
RpcServerInterfaceGroupActivate effectue la majeure partie du travail d’initialisation que les applications serveur RPC doivent effectuer. Il effectue les opérations suivantes :
- Indique au runtime RPC de commencer à écouter les appels.
- Inscrit les points de terminaison auprès du runtime du serveur.
- Inscrit les interfaces auprès du runtime du serveur.
- Inscrit les points de terminaison et les interfaces auprès du mappeur de point de terminaison RPC.
RpcServerInterfaceGroupActivate est atomique. Si, à un moment donné, l’opération échoue, tous les éléments précédemment inscrits sont annulés.
Les appels peuvent être distribués à l’application serveur avant le retour de cette fonction.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 8 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2012 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | rpcdce.h (inclure Rpc.h) |
| Bibliothèque | Rpcrt4.lib |
| DLL | Rpcrt4.dll |