rrpc_shutdown(3ncs)rrpc_shutdown(3ncs)Namerrpc_shutdown - shut down a server
Syntax
#include <idl/c/rrpc.h>
void rrpc_$shutdown(handle, status)
handle_t handle;
status_$t *status;
Arguments
handle A remote procedure call (RPC) handle.
status The completion status. If the completion status returned in is
equal to status_$ok , then the routine that supplied it was suc‐
cessful.
Description
The routine shuts down a server, if the server allows it. A server can
use the routine to allow or disallow remote shutdown.
Diagnostics
This section lists status codes for errors returned by this routine in
rrpc_$shutdown_not_allowd
You send an request to a server that has not issued an call.
Restrictions
On the client side, because of the way the calls are defined and imple‐
mented in the run-time library you must explicitly call into the entry
point vector table for the interface to send an request across the net‐
work. The following is an example of a call that works as desired:
(*rrpc_$client_epv.rrpc_$shutdown)(handle, &status);
The server side stub routine calls the entry point on behalf of the
client. The results of the call are then passed back to the client.
Before making the shutdown call, the server must have previously exe‐
cuted the following call:
rpc_$allow_remote_shutdown((unsigned long) TRUE,NULL,&status);
If the server has not allowed remote shutdown, the call returns an sta‐
tus code.
FilesSee Alsointro(3ncs), rpc_allow_remote_shutdown(3ncs), rpc_shutdown(3ncs)rrpc_shutdown(3ncs)