Partager via

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
RPC_S_OK
 L’appel a réussi.
RPC_S_PROTSEQ_NOT_SUPPORTED
 La séquence de protocole n’est pas prise en charge sur cet hôte.
RPC_S_INVALID_RPC_PROTSEQ
 La séquence de protocole n’est pas valide.
RPC_S_INVALID_ENDPOINT_FORMAT
 Format du point de terminaison non valide.
RPC_S_OUT_OF_MEMORY
 Le système est en mémoire insuffisante.
RPC_S_INVALID_SECURITY_DESC
 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

Voir aussi

RpcServerInterfaceGroupClose

RpcServerInterfaceGroupCreate

RpcServerInterfaceGroupDeactivate

RpcServerInterfaceGroupInqBindings

  • Last updated on