3.5.4.2.1 RestartRouter Method (Opnum 3)

The RestartRouter method stops and restarts the RRAS server.

 HRESULT RestartRouter([in] DWORD dwFlags);

dwFlags: This is unused and if set MUST be ignored by RRASM server.

Return Values: The server MUST return zero if it successfully processes the message. If processing fails, the server MUST return a nonzero HRESULT error code as defined in [MS-DTYP] section 2.2.18, between 0x80000000 and 0xFFFFFFFF, as specified in [MS-ERREF] section 2.1. For protocol purposes, all nonzero values MUST be treated as equivalent failures.

When processing this call, the RRASM server MUST do the following:

  • Call the abstract interface Invoke REMRAS method specifying the operation and the parameters to enable RRAS server to perform the required management task.

  • Return any error status the RRAS server returns. Otherwise return ERROR_SUCCESS.

No exceptions are thrown beyond those thrown by the underlying RPC protocol [MS-RPCE].