httpDisconnect()

Remove a registered Web-Resource

Synopsis

int httpDisconnect( string resourceName);

Parameter

Parameter Description
resourceName The URL name, which calls the given CTRL function when requested.

Return value

httpDisconnect() returns 0 on success, otherwise -1.

Error

Errors can be queried with getLastError(). Errors can be:

  • Too few arguments

  • No httpServer() is installed

  • httpConnect() is called from a different script than the httpServer() was installed from

  • The given resourceName is not registered

Description

The function httpDisconnect() removes the registration of a Web-Resource from the httpServer. The given Web-Resource is then no more available for client requests.

Example

The Web-Resource "/firstExample" shall be removed.

main()
{
  httpDisconnect("/firstExample");
}

Assignment

CTRL PlugIn

Availability

CTRL