Función RpcServerInterfaceGroupActivate (rpcdce.h)

  • Artículo

La función RpcServerInterfaceGroupActivate indica al tiempo de ejecución del servidor RPC que registre las interfaces y los puntos de conexión del grupo de interfaz y comience a escuchar las llamadas.

Sintaxis

RPC_STATUS RpcServerInterfaceGroupActivate(
  [in] RPC_INTERFACE_GROUP IfGroup
);

Parámetros

[in] IfGroup

Un RPC_INTERFACE_GROUP de RpcServerInterfaceGroupCreate que define el grupo de interfaz que se va a activar.

Valor devuelto

Valor Significado
RPC_S_OK
 La llamada se realizó correctamente.
RPC_S_PROTSEQ_NOT_SUPPORTED
 La secuencia de protocolos no se admite en este host.
RPC_S_INVALID_RPC_PROTSEQ
 La secuencia de protocolo no es válida.
RPC_S_INVALID_ENDPOINT_FORMAT
 El formato del punto de conexión no es válido.
RPC_S_OUT_OF_MEMORY
 El sistema está sin memoria.
RPC_S_INVALID_SECURITY_DESC
 El descriptor de seguridad de un punto de conexión o interfaz no es válido.
 
Nota Para obtener una lista de códigos de error válidos, vea Rpc Return Values.
 

Comentarios

RpcServerInterfaceGroupActivate realiza la mayor parte del trabajo de inicialización que deben realizar las aplicaciones de servidor RPC. Realiza las siguientes operaciones:

  • Indica al tiempo de ejecución de RPC que empiece a escuchar las llamadas.
  • Registra los puntos de conexión con el entorno de ejecución del servidor.
  • Registra las interfaces con el entorno de ejecución del servidor.
  • Registra los puntos de conexión e interfaces con el asignador de puntos de conexión RPC.

RpcServerInterfaceGroupActivate es atómico. Si en cualquier momento se produce un error en la operación, los elementos que se registraron anteriormente se deshacen.

Las llamadas se pueden enviar a la aplicación de servidor antes de que esta función devuelva.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado rpcdce.h (include Rpc.h)
Library Rpcrt4.lib
Archivo DLL Rpcrt4.dll

Consulte también

RpcServerInterfaceGroupClose

RpcServerInterfaceGroupCreate

RpcServerInterfaceGroupDeactivate

RpcServerInterfaceGroupInqBindings