3.1.4.3 Reboot (Opnum 9)

  • Article

This method is used to reboot the computer where the IIS service is running.

The server implementation MAY<6> not implement this function. If it does not, then it MUST return E_NOTIMPL.

 HRESULT Reboot(
   DWORD dwTimeouMsecs,
   DWORD dwForceAppsClosed
 );

dwTimeoutMsecs: Time, in milliseconds, that the user is to be provided to close applications before the computer restarts. After this time has elapsed, the applications MUST be forced to close if the dwForceAppsClosed parameter is set to 0x00000001.

dwForceAppsClosed: Boolean value that specifies whether applications will be forced to close.

Value

Meaning

TRUE

0x00000001

Applications MUST be forced to close.

FALSE

0x00000000

Applications MUST NOT be forced to close.

Return Values: A signed, 32-bit value indicating return status. If the method returns a negative value, it has failed. If the 12-bit facility code (bits 16–27) is set to 0x007, the value contains a Win32 error code in the lower 16 bits. 0 or positive values indicate success, with the lower 16 bits in positive nonzero values containing warnings or flags defined in the method implementation. For more information about HRESULT, see [MS-ERREF] section 2.1.

The method MUST return S_OK (0x00000000) upon success.

Return value/code

Description

0x00000000

S_OK

The call was successful.

0x80070008

E_ERROR_NOT_ENOUGH_MEMORY

Not enough memory is available to process this command.

0x800710D5

E_ERROR_RESOURCE_DISABLED

The IIisServiceControl interface is disabled.

0x80004001

E_NOTIMPL

This function is not supported for this version of the server.