grommunio / mapi-header-php

class.mapiexception.php

<?php
/*
 * SPDX-License-Identifier: AGPL-3.0-only
 * SPDX-FileCopyrightText: Copyright 2005-2016 Zarafa Deutschland GmbH
 * SPDX-FileCopyrightText: Copyright 2020-2022 grommunio GmbH
 */

/**
 * MAPIException
 * if enabled using mapi_enable_exceptions then php-ext can throw exceptions when
 * any error occurs in mapi calls. this exception will only be thrown when severity bit is set in
 * error code that means it will be thrown only for mapi errors not for mapi warnings.
 */
class MAPIException extends BaseException {
	/**
	 * Function will return display message of exception if its set by the callee.
	 * if it is not set then we are generating some default display messages based
	 * on mapi error code.
	 *
	 * @return string returns error-message that should be sent to client to display
	 */
	public function getDisplayMessage() {
		if (!empty($this->displayMessage)) {
			return $this->displayMessage;
		}

		switch ($this->getCode()) {
			/* see also class.webappauthentication.php:getErrorMessage for more instances */

			case MAPI_E_NO_ACCESS:

The constant MAPI_E_NO_ACCESS was not found. Maybe you did not declare it correctly or list all dependencies?

				return dgettext("zarafa", "You have insufficient privileges to open this object.");

			case ecUnknownUser:

The constant ecUnknownUser was not found. Maybe you did not declare it correctly or list all dependencies?

			case MAPI_E_LOGON_FAILED:

The constant MAPI_E_LOGON_FAILED was not found. Maybe you did not declare it correctly or list all dependencies?

			case MAPI_E_UNCONFIGURED:

The constant MAPI_E_UNCONFIGURED was not found. Maybe you did not declare it correctly or list all dependencies?

				return dgettext("zarafa", "Logon Failed. Please check your name/password.");

			case MAPI_E_NETWORK_ERROR:

The constant MAPI_E_NETWORK_ERROR was not found. Maybe you did not declare it correctly or list all dependencies?

				return dgettext("zarafa", "Can not connect to Gromox.");

			case MAPI_E_UNKNOWN_ENTRYID:

The constant MAPI_E_UNKNOWN_ENTRYID was not found. Maybe you did not declare it correctly or list all dependencies?

				return dgettext("zarafa", "Can not open object with provided id.");

			case MAPI_E_NO_RECIPIENTS:

The constant MAPI_E_NO_RECIPIENTS was not found. Maybe you did not declare it correctly or list all dependencies?

				return dgettext("zarafa", "There are no recipients in the message.");

			case MAPI_E_NOT_FOUND:

The constant MAPI_E_NOT_FOUND was not found. Maybe you did not declare it correctly or list all dependencies?

				return dgettext("zarafa", "Can not find object.");

			case MAPI_E_NOT_ENOUGH_MEMORY:

The constant MAPI_E_NOT_ENOUGH_MEMORY was not found. Maybe you did not declare it correctly or list all dependencies?

				return dgettext("zarafa", "Operation failed: Server does not have enough memory.");

			case MAPI_E_INTERFACE_NOT_SUPPORTED:

The constant MAPI_E_INTERFACE_NOT_SUPPORTED was not found. Maybe you did not declare it correctly or list all dependencies?

			case MAPI_E_INVALID_PARAMETER:

The constant MAPI_E_INVALID_PARAMETER was not found. Maybe you did not declare it correctly or list all dependencies?

			case MAPI_E_INVALID_ENTRYID:

The constant MAPI_E_INVALID_ENTRYID was not found. Maybe you did not declare it correctly or list all dependencies?

			case MAPI_E_INVALID_OBJECT:

The constant MAPI_E_INVALID_OBJECT was not found. Maybe you did not declare it correctly or list all dependencies?

			case MAPI_E_TOO_COMPLEX:

The constant MAPI_E_TOO_COMPLEX was not found. Maybe you did not declare it correctly or list all dependencies?

			case MAPI_E_CORRUPT_DATA:

The constant MAPI_E_CORRUPT_DATA was not found. Maybe you did not declare it correctly or list all dependencies?

			case MAPI_E_END_OF_SESSION:

The constant MAPI_E_END_OF_SESSION was not found. Maybe you did not declare it correctly or list all dependencies?

			case MAPI_E_AMBIGUOUS_RECIP:

The constant MAPI_E_AMBIGUOUS_RECIP was not found. Maybe you did not declare it correctly or list all dependencies?

			case MAPI_E_COLLISION:

The constant MAPI_E_COLLISION was not found. Maybe you did not declare it correctly or list all dependencies?

			case MAPI_E_UNCONFIGURED:
			default:
				return sprintf(dgettext("zarafa", "Unknown MAPI Error: %s"), get_mapi_error_name($this->getCode()));
		}
	}
}

// Tell the PHP extension which exception class to instantiate
if (function_exists('mapi_enable_exceptions')) {
	mapi_enable_exceptions("mapiexception");
}