Poco::UPnP

class UPnPException

Library: UPnP
Package: Core
Header: Poco/UPnP/UPnPException.h

Description

This exception class is used for UPnP specific errors.

It should be used for reporting errors for which a service specification defines a specific UPnP error code.

Inheritance

Direct Base Classes: Poco::Exception

All Base Classes: Poco::Exception, std::exception

Member Summary

Member Functions: className, clone, codeIsValid, description, name, operator =, registerCode, rethrow

Inherited Functions: className, clone, code, displayText, extendedMessage, message, name, nested, operator =, rethrow, what

Enumerations

CodeRanges

RANGE_COMMON_ERROR_START = 600

RANGE_COMMON_ERROR_END = 699

RANGE_ACTION_SPECIFIC_ERROR_START = 700

RANGE_ACTION_SPECIFIC_ERROR_END = 799

RANGE_VENDOR_SPECIFIC_START = 800

RANGE_VENDOR_SPECIFIC_END = 899

PredefinedErrorCode

CODE_INVALID_ACTION = 401

CODE_INVALID_ARGS = 402

CODE_ACTION_FAILED = 501

CODE_ARGUMENT_VALUE_INVALID = 600

CODE_ARGUMENT_VALUE_OUT_OF_RANGE = 601

CODE_OPTIONAL_ACTION_NOT_IMPLEMENTED = 602

CODE_OUT_OF_MEMORY = 603

CODE_HUMAN_INTERVENTION_REQUIRED = 604

CODE_STRING_ARGUMENT_TOO_LONG = 605

CODE_ACTION_NOT_AUTHORIZED = 606

CODE_SIGNATURE_FAILURE = 607

CODE_SIGNATURE_MISSING = 608

CODE_NOT_ENCRYPTED = 609

CODE_INVALID_SEQUENCE = 610

CODE_INVALID_CONTROL_URL = 611

CODE_NO_SUCH_SESSION = 612

Constructors

UPnPException

UPnPException(
    int code
);

UPnPException

UPnPException(
    const UPnPException & exc
);

UPnPException

UPnPException(
    const std::string & msg,
    int code
);

UPnPException

UPnPException(
    const std::string & msg,
    const std::string & arg,
    int code
);

UPnPException

UPnPException(
    const std::string & msg,
    const Poco::Exception & exc,
    int code
);

Destructor

~UPnPException

~UPnPException();

Member Functions

className virtual

const char * className() const;

clone

Poco::Exception * clone() const;

codeIsValid static

static bool codeIsValid(
    int code
);

Checks if an error code is valid, ie. it has beed registered. Returns true if the code has been registered, false otherwise.

description static

static const std::string & description(
    int code
);

Returns a description for the given error code.

If no description for the error code has been registered, returns an empty string.

name virtual

const char * name() const;

operator =

UPnPException & operator = (
    const UPnPException & exc
);

registerCode static

static void registerCode(
    int code,
    const std::string & desc
);

Registers a new error code. The code must be in a valid int range defined by the UPnP standard. Only values in the range 613-899 can be registered. All other values are either forbidden or assigned a static text.

rethrow virtual

void rethrow() const;

Securely control IoT edge devices from anywhere   Connect a Device