RpcServerInterfaceGroupActivate function (rpcdce.h)
The RpcServerInterfaceGroupActivate function tells the RPC server runtime to register the interface group’s interfaces and endpoints and begin listening for calls.
Syntax
RPC_STATUS RpcServerInterfaceGroupActivate(
[in] RPC_INTERFACE_GROUP IfGroup
);
Parameters
[in] IfGroup
A RPC_INTERFACE_GROUP from RpcServerInterfaceGroupCreate that defines the interface group to activate.
Return value
Value | Meaning |
---|---|
|
The call succeeded. |
|
The protocol sequence is not supported on this host. |
|
The protocol sequence is invalid. |
|
The endpoint format is invalid. |
|
The system is out of memory. |
|
The security descriptor for an endpoint or interface is invalid. |
Remarks
RpcServerInterfaceGroupActivate does the bulk of the initialization work that the RPC server applications need to do. It performs the following operations:
- Instructs the RPC runtime to begin listening for calls.
- Registers the endpoints with the server runtime.
- Registers the interfaces with the server runtime.
- Registers the endpoints and interfaces with the RPC endpoint mapper.
RpcServerInterfaceGroupActivate is atomic. If at any point the operation fails, any items that were previously registered are undone.
Calls may be dispatched to the server application before this function returns.
Requirements
Requirement | Value |
---|---|
Minimum supported client | Windows 8 [desktop apps only] |
Minimum supported server | Windows Server 2012 [desktop apps only] |
Target Platform | Windows |
Header | rpcdce.h (include Rpc.h) |
Library | Rpcrt4.lib |
DLL | Rpcrt4.dll |