Password policy group provides APIs to control password policies.

Required Header

#include <dpm/password.h>

Overview

Password policy group provides APIs to control password policies such as password type, password quality and expiration date. Any API which requires privileges is only available for the registered device admin client which is enrolled to the device by enrollment process.

Functions
int	dpm_password_set_quality (device_policy_manager_h handle, int quality)
	Sets password quality.
int	dpm_password_get_quality (device_policy_manager_h handle, int *quality)
	Gets password quality.
int	dpm_password_set_minimum_length (device_policy_manager_h handle, int value)
	Sets password minimum length.
int	dpm_password_get_minimum_length (device_policy_manager_h handle, int *value)
	Gets password minimum length.
int	dpm_password_set_min_complex_chars (device_policy_manager_h handle, int value)
	Sets minimum complex char in password.
int	dpm_password_get_min_complex_chars (device_policy_manager_h handle, int *value)
	Gets minimum complex char in password.
int	dpm_password_set_maximum_failed_attempts_for_wipe (device_policy_manager_h handle, int value)
	Sets maximum number of failed attempts before device is wiped.
int	dpm_password_get_maximum_failed_attempts_for_wipe (device_policy_manager_h handle, int *value)
	Gets maximum number of failed attempts before device is wiped.
int	dpm_password_set_expires (device_policy_manager_h handle, int value)
	Sets the number of days password expires.
int	dpm_password_get_expires (device_policy_manager_h handle, int *value)
	Gets the number of days password expires.
int	dpm_password_set_history (device_policy_manager_h handle, int value)
	Sets the number of min password history to avoid previous password.
int	dpm_password_get_history (device_policy_manager_h handle, int *value)
	Gets the number of min password history to avoid previous password.
int	dpm_password_set_pattern (device_policy_manager_h handle, const char *pattern)
	Sets the required password pattern.
int	dpm_password_reset (device_policy_manager_h handle, const char *password)
	Resets password.
int	dpm_password_enforce_change (device_policy_manager_h handle)
	Enforces password change.
int	dpm_password_set_max_inactivity_time_device_lock (device_policy_manager_h handle, int value)
	Sets the maximum number of seconds of inactivity time before the screen timeout occurs.
int	dpm_password_get_max_inactivity_time_device_lock (device_policy_manager_h handle, int *value)
	Gets the maximum number of seconds of inactivity time before the screen timeout occurs.
int	dpm_password_set_status (device_policy_manager_h handle, dpm_password_status_e status)
	Sets password status.
int	dpm_password_get_status (device_policy_manager_h handle, dpm_password_status_e *status)
	Gets password status.
int	dpm_password_delete_pattern (device_policy_manager_h handle)
	Removes all password patterns.
int	dpm_password_get_pattern (device_policy_manager_h handle, char **pattern)
	Gets password pattern.
int	dpm_password_set_maximum_character_occurrences (device_policy_manager_h handle, int value)
	Sets the maximum number of times a character can occur in the device password.
int	dpm_password_get_maximum_character_occurrences (device_policy_manager_h handle, int *value)
	Gets the maximum number of times a character can occur in the device password.
int	dpm_password_set_maximum_numeric_sequence_length (device_policy_manager_h handle, int value)
	Sets the maximum length of the numeric sequence which is allowed in the device password.
int	dpm_password_get_maximum_numeric_sequence_length (device_policy_manager_h handle, int *value)
	Gets the maximum numeric sequence length allowed in the device password.
dpm_password_iterator_h	dpm_password_create_iterator (device_policy_manager_h handle)
	Creates a password forbidden string list iterator.
int	dpm_password_iterator_next (dpm_password_iterator_h iter, const char **forbidden_string)
	Fetches a password forbidden string and forwards the iterator.
int	dpm_password_destroy_iterator (dpm_password_iterator_h iter)
	Frees the password forbidden string iterator.
int	dpm_password_set_forbidden_strings (device_policy_manager_h handle, const char *strings[], int length)
	Sets strings which are forbidden in the device password.
Typedefs
typedef void *	dpm_password_iterator_h
	The password forbidden string list iterator handle.

Typedef Documentation

typedef void* dpm_password_iterator_h

The password forbidden string list iterator handle.

Since :: 3.0

See also:: dpm_password_create_iterator(); dpm_password_iterator_next(); dpm_password_destroy_iterator()

Enumeration Type Documentation

enum dpm_password_quality_e

Enumeration for dpm password quality type.

Since :: 3.0

Enumerator:

DPM_PASSWORD_QUALITY_UNSPECIFIED	No requirements for password.
DPM_PASSWORD_QUALITY_SIMPLE_PASSWORD	EAS(Exchange ActiveSync) requirement for simple password
DPM_PASSWORD_QUALITY_SOMETHING	Some kind password is required, but doesn't care what it is
DPM_PASSWORD_QUALITY_NUMERIC	Containing at least numeric characters
DPM_PASSWORD_QUALITY_ALPHABETIC	Containing at least alphabetic (or other symbol) characters
DPM_PASSWORD_QUALITY_ALPHANUMERIC	Containing at least numeric and alphabetic characters

enum dpm_password_status_e

Enumeration for dpm password status type.

Since :: 3.0

Enumerator:

DPM_PASSWORD_STATUS_NORMAL	Password normal status
DPM_PASSWORD_STATUS_CHANGED	Password successfully changed
DPM_PASSWORD_STATUS_NOT_CHANGED	Password not changed
DPM_PASSWORD_STATUS_CHANGE_REQUIRED	Password change required
DPM_PASSWORD_STATUS_MAX_ATTEMPTS_EXCEEDED	Password Max Attempts Exceeded
DPM_PASSWORD_STATUS_EXPIRED	Password expired
DPM_PASSWORD_STATUS_RECOVERY_PASSWORD_FAILED	Device unlock failed by Password Recovery
DPM_PASSWORD_STATUS_RECOVERY_PASSWORD_SUCCEEDED	Device unlock succeeded by Password Recovery
DPM_PASSWORD_STATUS_QUALITY_CHANGED	Password quality successfully changed
DPM_PASSWORD_STATUS_MIN_LENGTH_CHANGED	Password min_length successfully changed
DPM_PASSWORD_STATUS_COMPLEX_CHAR_CHANGED	Password complex_char successfully changed
DPM_PASSWORD_STATUS_PATTERN_CHANGED	Password pattern successfully changed

Function Documentation

dpm_password_iterator_h dpm_password_create_iterator ( device_policy_manager_h handle )

Creates a password forbidden string list iterator.

Warning:: This is not for use by third-party applications.

The password forbidden string list iterator can be used to get all forbidden strings.

Since :: 3.0

Privilege Level:: partner

Privilege:: http://tizen.org/privilege/dpm.password

Parameters:

[in] handle Device policy manager handle

Returns:: A password forbidden string list iterator on success, otherwise null value

Remarks:: The specific error code can be obtained by using the get_last_result() method. Error codes are described in exception section. The returned iterator should be released using dpm_password_destroy_iterator().

Exceptions:

DPM_ERROR_NONE	No error
DPM_ERROR_OUT_OF_MEMORY	Out of memory
DPM_ERROR_INVALID_PARAMETER	Invalid parameter
DPM_ERROR_TIMED_OUT	Time out
DPM_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this API

Precondition:: The handle must be created by dpm_manager_create().

See also:: dpm_manager_create(); dpm_password_iterator_next(); dpm_password_destroy_iterator(); get_last_result()

int dpm_password_delete_pattern ( device_policy_manager_h handle )

Removes all password patterns.

Warning:: This is not for use by third-party applications.

An administrator can remove all password patterns.

Since :: 3.0

Privilege Level:: partner

Privilege:: http://tizen.org/privilege/dpm.password

Parameters:

[in] handle Device policy manager handle

Returns:: DPM_ERROR_NONE on success, otherwise a negative value

Return values:

DPM_ERROR_NONE	Successful
DPM_ERROR_INVALID_PARAMETER	Invalid parameter
DPM_ERROR_TIMED_OUT	Time out
DPM_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this API

Precondition:: The handle must be created by dpm_manager_create().

See also:: dpm_manager_create()

int dpm_password_destroy_iterator ( dpm_password_iterator_h iter )

Frees the password forbidden string iterator.

Warning:: This is not for use by third-party applications.

This API frees the password forbidden string iterator. This API must be called if the iterator no longer used.

Since :: 3.0

Privilege Level:: partner

Privilege:: http://tizen.org/privilege/dpm.password

Parameters:

[in] iter The iterator to be removed

Returns:: DPM_ERROR_NONE on success, otherwise a negative value

Return values:

DPM_ERROR_NONE	Successful
DPM_ERROR_INVALID_PARAMETER	Invalid parameter
DPM_ERROR_TIMED_OUT	Time out
DPM_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this API

Precondition:: The iter must be created by dpm_password_create_iterator()

See also:: dpm_password_create_iterator(); dpm_password_iterator_next()

int dpm_password_enforce_change ( device_policy_manager_h handle )

Enforces password change.

Warning:: This is not for use by third-party applications.

An administrator can enforce password change. PasswordPolicy change setting is launched.

Since :: 3.0

Privilege Level:: partner

Privilege:: http://tizen.org/privilege/dpm.password

Parameters:

[in] handle Device policy manager handle

Returns:: DPM_ERROR_NONE on success, otherwise a negative value

Return values:

DPM_ERROR_NONE	Successful
DPM_ERROR_INVALID_PARAMETER	Invalid parameter
DPM_ERROR_TIMED_OUT	Time out
DPM_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this API

Precondition:: The handle must be created by dpm_manager_create().

See also:: dpm_manager_create()

int dpm_password_get_expires	(	device_policy_manager_h	handle,
		int *	value
	)

Gets the number of days password expires.

Warning:: This is not for use by third-party applications.

An administrator can get the password age to force the user to enter a new password after every expiration period.

Since :: 3.0

Privilege Level:: partner

Privilege:: http://tizen.org/privilege/dpm.password

Parameters:

[in]	handle	Device policy manager handle
[out]	value	Number of days after which the password expires.

Returns:: DPM_ERROR_NONE on success, otherwise a negative value

Return values:

DPM_ERROR_NONE	Successful
DPM_ERROR_INVALID_PARAMETER	Invalid parameter
DPM_ERROR_TIMED_OUT	Time out
DPM_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this API

Precondition:: The handle must be created by dpm_manager_create().

See also:: dpm_manager_create()

int dpm_password_get_history	(	device_policy_manager_h	handle,
		int *	value
	)

Gets the number of min password history to avoid previous password.

Warning:: This is not for use by third-party applications.

An administrator can get the number of previous passwords which cannot be used when entering a new password.

Since :: 3.0

Privilege Level:: partner

Privilege:: http://tizen.org/privilege/dpm.password

Parameters:

[in]	handle	Device policy manager handle
[out]	value	Number of previous passwords which cannot be used when settings a new password.

Returns:: DPM_ERROR_NONE on success, otherwise a negative value

Return values:

DPM_ERROR_NONE	Successful
DPM_ERROR_INVALID_PARAMETER	Invalid parameter
DPM_ERROR_TIMED_OUT	Time out
DPM_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this API

Precondition:: The handle must be created by dpm_manager_create().

See also:: dpm_manager_create()

int dpm_password_get_max_inactivity_time_device_lock	(	device_policy_manager_h	handle,
		int *	value
	)

Gets the maximum number of seconds of inactivity time before the screen timeout occurs.

Warning:: This is not for use by third-party applications.

Called by an application that is managing the device to get the value of timeout period.

Since :: 3.0

Privilege Level:: partner

Privilege:: http://tizen.org/privilege/dpm.password

Parameters:

[in]	handle	Device policy manager handle
[out]	value	Pointer of Maximum inactivity time for device lock.

Returns:: DPM_ERROR_NONE on success, otherwise a negative value

Return values:

DPM_ERROR_NONE	Successful
DPM_ERROR_INVALID_PARAMETER	Invalid parameter
DPM_ERROR_TIMED_OUT	Time out
DPM_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this API

Precondition:: The handle must be created by dpm_manager_create().

See also:: dpm_manager_create()

int dpm_password_get_maximum_character_occurrences	(	device_policy_manager_h	handle,
		int *	value
	)

Gets the maximum number of times a character can occur in the device password.

Warning:: This is not for use by third-party applications.

An administrator can retrieve the maximum number of times a character can occur in the device password. If more than one admin has set this value then the least value will take preference.

Since :: 3.0

Privilege Level:: partner

Privilege:: http://tizen.org/privilege/dpm.password

Parameters:

[in]	handle	Device policy manager handle
[out]	value	Pointer of Maximum Character Occurrences

Returns:: DPM_ERROR_NONE on success, otherwise a negative value

Return values:

DPM_ERROR_NONE	Successful
DPM_ERROR_INVALID_PARAMETER	Invalid parameter
DPM_ERROR_TIMED_OUT	Time out
DPM_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this API

Precondition:: The handle must be created by dpm_manager_create().

See also:: dpm_manager_create()

int dpm_password_get_maximum_failed_attempts_for_wipe	(	device_policy_manager_h	handle,
		int *	value
	)

Gets maximum number of failed attempts before device is wiped.

Warning:: This is not for use by third-party applications.

If user fails the last attempt, device will be wiped.

Since :: 3.0

Privilege Level:: partner

Privilege:: http://tizen.org/privilege/dpm.password

Parameters:

[in]	handle	Device policy manager handle
[out]	value	Maximum count for failed passwords.

Returns:: DPM_ERROR_NONE on success, otherwise a negative value

Return values:

DPM_ERROR_NONE	Successful
DPM_ERROR_INVALID_PARAMETER	Invalid parameter
DPM_ERROR_TIMED_OUT	Time out
DPM_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this API

Precondition:: The handle must be created by dpm_manager_create().

See also:: dpm_manager_create()

int dpm_password_get_maximum_numeric_sequence_length	(	device_policy_manager_h	handle,
		int *	value
	)

Gets the maximum numeric sequence length allowed in the device password.

Warning:: This is not for use by third-party applications.

An administrator can retrieve the length of numeric sequences which are allowed in the device password. For instance, if the return value is '3' then "123", "987", "555" would all be numeric sequences of length '3' and will be allowed in the device password. If more than one admin has set this value then the least value will take preference.

Since :: 3.0

Privilege Level:: partner

Privilege:: http://tizen.org/privilege/dpm.password

Parameters:

[in]	handle	Device policy manager handle
[out]	value	Pointer of maximum numeric sequence length

Returns:: DPM_ERROR_NONE on success, otherwise a negative value

Return values:

DPM_ERROR_NONE	Successful
DPM_ERROR_INVALID_PARAMETER	Invalid parameter
DPM_ERROR_TIMED_OUT	Time out
DPM_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this API

Precondition:: The handle must be created by dpm_manager_create().

See also:: dpm_manager_create()

int dpm_password_get_min_complex_chars	(	device_policy_manager_h	handle,
		int *	value
	)

Gets minimum complex char in password.

Warning:: This is not for use by third-party applications.

Complex characters are all non-alphabetic characters; that is, numbers and symbols.

Since :: 3.0

Privilege Level:: partner

Privilege:: http://tizen.org/privilege/dpm.password

Parameters:

[in]	handle	Device policy manager handle
[out]	value	Number of minimum complex char in password.

Returns:: DPM_ERROR_NONE on success, otherwise a negative value

Return values:

DPM_ERROR_NONE	Successful
DPM_ERROR_INVALID_PARAMETER	Invalid parameter
DPM_ERROR_TIMED_OUT	Time out
DPM_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this API

Precondition:: The handle must be created by dpm_manager_create().

See also:: dpm_manager_create()

int dpm_password_get_minimum_length	(	device_policy_manager_h	handle,
		int *	value
	)

Gets password minimum length.

Warning:: This is not for use by third-party applications.

Gets the minimum allowed password length.

Since :: 3.0

Privilege Level:: partner

Privilege:: http://tizen.org/privilege/dpm.password

Parameters:

[in]	handle	Device policy manager handle
[out]	value	Allowed minimum password length

Returns:: DPM_ERROR_NONE on success, otherwise a negative value

Return values:

DPM_ERROR_NONE	Successful
DPM_ERROR_INVALID_PARAMETER	Invalid parameter
DPM_ERROR_TIMED_OUT	Time out
DPM_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this API

Precondition:: The handle must be created by dpm_manager_create().

See also:: dpm_manager_create()

int dpm_password_get_pattern	(	device_policy_manager_h	handle,
		char **	pattern
	)

Gets password pattern.

Warning:: This is not for use by third-party applications.

This API can be used for applying complexity on new password value.

Since :: 3.0

Privilege Level:: partner

Privilege:: http://tizen.org/privilege/dpm.password

Remarks:: The pattern should be freed using free().

Parameters:

[in]	handle	Device policy manager handle
[out]	pattern	Password pattern

Returns:: DPM_ERROR_NONE on success, otherwise a negative value

Return values:

DPM_ERROR_NONE	Successful
DPM_ERROR_INVALID_PARAMETER	Invalid parameter
DPM_ERROR_TIMED_OUT	Time out
DPM_ERROR_OUT_OF_MEMORY	Out of memory
DPM_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this API

Precondition:: The handle must be created by dpm_manager_create().

See also:: dpm_manager_create()

int dpm_password_get_quality	(	device_policy_manager_h	handle,
		int *	quality
	)

Gets password quality.

Warning:: This is not for use by third-party applications.

An administrator can get the password restrictions it is imposing.

Since :: 3.0

Privilege Level:: partner

Privilege:: http://tizen.org/privilege/dpm.password

Parameters:

[in]	handle	Device policy manager handle
[out]	quality	Password quality type, values of dpm_password_quality_e combined with bitwise 'or'

Returns:: DPM_ERROR_NONE on success, otherwise a negative value

Return values:

DPM_ERROR_NONE	Successful
DPM_ERROR_INVALID_PARAMETER	Invalid parameter
DPM_ERROR_TIMED_OUT	Time out
DPM_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this API

Precondition:: The handle must be created by dpm_manager_create().

See also:: dpm_manager_create()

int dpm_password_get_status	(	device_policy_manager_h	handle,
		dpm_password_status_e *	status
	)

Gets password status.

Warning:: This is not for use by third-party applications.

An administrator can know password status for this API.

Since :: 3.0

Parameters:

[in]	handle	Device policy manager handle
[out]	status	Password status

Returns:: DPM_ERROR_NONE on success, otherwise a negative value

Return values:

DPM_ERROR_NONE	Successful
DPM_ERROR_INVALID_PARAMETER	Invalid parameter
DPM_ERROR_TIMED_OUT	Time out

Precondition:: The handle must be created by dpm_manager_create().

See also:: dpm_manager_create()

int dpm_password_iterator_next	(	dpm_password_iterator_h	iter,
		const char **	forbidden_string
	)

Fetches a password forbidden string and forwards the iterator.

Warning:: This is not for use by third-party applications.

This API returns a password forbidden string indicated by the iterator, and then the iterator is moved to the next position. If the iterator reaches the end of the list, null value will be returned.

Since :: 3.0

Parameters:

[in]	iter	The iterator to be controlled
[out]	forbidden_string	The forbidden string got from the iterator

Returns:: DPM_ERROR_NONE on success, otherwise a negative value

Remarks:: The forbidden_string should not be freed using free().

Return values:

DPM_ERROR_NONE	Successful
DPM_ERROR_INVALID_PARAMETER	Invalid parameter
DPM_ERROR_TIMED_OUT	Time out

Precondition:: The iter must be created by dpm_password_create_iterator().

See also:: dpm_password_create_iterator(); dpm_password_destroy_iterator()

int dpm_password_reset	(	device_policy_manager_h	handle,
		const char *	password
	)

Resets password.

Warning:: This is not for use by third-party applications.

This takes effect immediately to the device password.

Since :: 3.0

Privilege Level:: partner

Privilege:: http://tizen.org/privilege/dpm.password

Parameters:

[in]	handle	Device policy manager handle
[in]	password	New password

Returns:: DPM_ERROR_NONE on success, otherwise a negative value

Return values:

DPM_ERROR_NONE	Successful
DPM_ERROR_INVALID_PARAMETER	Invalid parameter
DPM_ERROR_TIMED_OUT	Time out
DPM_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this API

Precondition:: The handle must be created by dpm_manager_create().

See also:: dpm_manager_create()

int dpm_password_set_expires	(	device_policy_manager_h	handle,
		int	value
	)

Sets the number of days password expires.

Warning:: This is not for use by third-party applications.

An administrator can configure the password age to force the user to enter a new password after every expiration period.

Since :: 3.0

Privilege Level:: partner

Privilege:: http://tizen.org/privilege/dpm.password

Parameters:

[in]	handle	Device policy manager handle
[in]	value	Number of days after which the password expires.

Returns:: DPM_ERROR_NONE on success, otherwise a negative value

Return values:

DPM_ERROR_NONE	Successful
DPM_ERROR_INVALID_PARAMETER	Invalid parameter
DPM_ERROR_TIMED_OUT	Time out
DPM_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this API

Precondition:: The handle must be created by dpm_manager_create().

See also:: dpm_manager_create()

int dpm_password_set_forbidden_strings	(	device_policy_manager_h	handle,
		const char *	strings[],
		int	length
	)

Sets strings which are forbidden in the device password.

Warning:: This is not for use by third-party applications.

Called by an admin that is managing the device to set strings that are forbidden to be used in the device password. This specifies any strings which must not be present in the device password such as personal data (variations on the user's name, email address or X400 address), or any other strings. If the parameter list has only one blank string(""), then the stored strings are cleared.

Since :: 3.0

Privilege Level:: partner

Privilege:: http://tizen.org/privilege/dpm.password

Parameters:

[in]	handle	Device policy manager handle
[in]	strings	The forbidden strings
[in]	length	The length of the strings

Returns:: DPM_ERROR_NONE on success, otherwise a negative value

Return values:

DPM_ERROR_NONE	Successful
DPM_ERROR_INVALID_PARAMETER	Invalid parameter
DPM_ERROR_TIMED_OUT	Time out
DPM_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this API

Precondition:: The handle must be created by dpm_manager_create().

See also:: dpm_manager_create()

int dpm_password_set_history	(	device_policy_manager_h	handle,
		int	value
	)

Sets the number of min password history to avoid previous password.

Warning:: This is not for use by third-party applications.

An administrator can configure the number of previous passwords which cannot be used when entering a new password.

Since :: 3.0

Privilege Level:: partner

Privilege:: http://tizen.org/privilege/dpm.password

Parameters:

[in]	handle	Device policy manager handle
[in]	value	Number of previous passwords which cannot be used when settings a new password.

Returns:: DPM_ERROR_NONE on success, otherwise a negative value

Return values:

DPM_ERROR_NONE	Successful
DPM_ERROR_INVALID_PARAMETER	Invalid parameter
DPM_ERROR_TIMED_OUT	Time out
DPM_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this API

Precondition:: The handle must be created by dpm_manager_create().

See also:: dpm_manager_create()

int dpm_password_set_max_inactivity_time_device_lock	(	device_policy_manager_h	handle,
		int	value
	)

Sets the maximum number of seconds of inactivity time before the screen timeout occurs.

Warning:: This is not for use by third-party applications.

An administrator sets the maximum number of seconds of inactivity time before the screen timeout occurs and a device user must type the password to unlock the device.

Since :: 3.0

Privilege Level:: partner

Privilege:: http://tizen.org/privilege/dpm.password

Parameters:

[in]	handle	Device policy manager handle
[in]	value	Maximum inactivity time for device lock. Specifies how soon the device can be unlocked again after use, without reprompting for the passcode.

Returns:: DPM_ERROR_NONE on success, otherwise a negative value

Return values:

DPM_ERROR_NONE	Successful
DPM_ERROR_INVALID_PARAMETER	Invalid parameter
DPM_ERROR_TIMED_OUT	Time out
DPM_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this API

Precondition:: The handle must be created by dpm_manager_create().

See also:: dpm_manager_create()

int dpm_password_set_maximum_character_occurrences	(	device_policy_manager_h	handle,
		int	value
	)

Sets the maximum number of times a character can occur in the device password.

Warning:: This is not for use by third-party applications.

Called by an admin that is managing the device to specify that any character in the device password cannot occur more than the specified maximum number of times. Characters can be numeric or alphabetic or symbolic. "aaabcde" has 'a' which occurs 3 times, "1b1c1de" has '1' which occurs 3 times and "a@b@c@" has '@' which occurs 3 times. A value of '0' specifies that no restrictions are applied.

Since :: 3.0

Privilege Level:: partner

Privilege:: http://tizen.org/privilege/dpm.password

Parameters:

[in]	handle	Device policy manager handle
[in]	value	Maximum character occurrences

Returns:: DPM_ERROR_NONE on success, otherwise a negative value

Return values:

DPM_ERROR_NONE	Successful
DPM_ERROR_INVALID_PARAMETER	Invalid parameter
DPM_ERROR_TIMED_OUT	Time out
DPM_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this API

Precondition:: The handle must be created by dpm_manager_create().

See also:: dpm_manager_create()

int dpm_password_set_maximum_failed_attempts_for_wipe	(	device_policy_manager_h	handle,
		int	value
	)

Sets maximum number of failed attempts before device is wiped.

Warning:: This is not for use by third-party applications.

If user fails the last attempt, device will be wiped.

Since :: 3.0

Privilege Level:: partner

Privilege:: http://tizen.org/privilege/dpm.password

Parameters:

[in]	handle	Device policy manager handle
[in]	value	Maximum count for failed passwords.

Returns:: DPM_ERROR_NONE on success, otherwise a negative value

Return values:

DPM_ERROR_NONE	Successful
DPM_ERROR_INVALID_PARAMETER	Invalid parameter
DPM_ERROR_TIMED_OUT	Time out
DPM_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this API

Precondition:: The handle must be created by dpm_manager_create().

See also:: dpm_manager_create()

int dpm_password_set_maximum_numeric_sequence_length	(	device_policy_manager_h	handle,
		int	value
	)

Sets the maximum length of the numeric sequence which is allowed in the device password.

Warning:: This is not for use by third-party applications.

Called by an administrator that is managing the device to set the maximum numeric sequence length. This specifies that the device password must not contain numeric sequences greater than the given length. Numeric sequences can be increasing successively by one like "12345", or decreasing successively by one like "98765", or repeating like "55555". These are all numeric sequences of length '5'. If maximum value is set to '5' then "123456" or "987654" or "555555" are not allowed. A value of '0' specifies that no such numeric sequence restrictions are applied.

Since :: 3.0

Privilege Level:: partner

Privilege:: http://tizen.org/privilege/dpm.password

Parameters:

[in]	handle	Device policy manager handle
[in]	value	Maximum numeric sequence length

Returns:: DPM_ERROR_NONE on success, otherwise a negative value

Return values:

DPM_ERROR_NONE	Successful
DPM_ERROR_INVALID_PARAMETER	Invalid parameter
DPM_ERROR_TIMED_OUT	Time out
DPM_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this API

Precondition:: The handle must be created by dpm_manager_create().

See also:: dpm_manager_create()

int dpm_password_set_min_complex_chars	(	device_policy_manager_h	handle,
		int	value
	)

Sets minimum complex char in password.

Warning:: This is not for use by third-party applications.

Complex characters are all non-alphabetic characters; that is, numbers and symbols. Admin can configure this setting and make the password more secure.

Since :: 3.0

Privilege Level:: partner

Privilege:: http://tizen.org/privilege/dpm.password

Parameters:

[in]	handle	Device policy manager handle
[in]	value	Number of minimum complex char in password.

Returns:: DPM_ERROR_NONE on success, otherwise a negative value

Return values:

DPM_ERROR_NONE	Successful
DPM_ERROR_INVALID_PARAMETER	Invalid parameter
DPM_ERROR_TIMED_OUT	Time out
DPM_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this API

Precondition:: The handle must be created by dpm_manager_create().

See also:: dpm_manager_create()

int dpm_password_set_minimum_length	(	device_policy_manager_h	handle,
		int	value
	)

Sets password minimum length.

Warning:: This is not for use by third-party applications.

Sets the minimum allowed password length. After setting this, the user will not be able to enter a new password that is shorter than the setting length.

Since :: 3.0

Privilege Level:: partner

Privilege:: http://tizen.org/privilege/dpm.password

Parameters:

[in]	handle	Device policy manager handle
[in]	value	Allowed minimum password length

Returns:: DPM_ERROR_NONE on success, otherwise a negative value

Return values:

DPM_ERROR_NONE	Successful
DPM_ERROR_INVALID_PARAMETER	Invalid parameter
DPM_ERROR_TIMED_OUT	Time out
DPM_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this API

Precondition:: The handle must be created by dpm_manager_create().

See also:: dpm_manager_create()

int dpm_password_set_pattern	(	device_policy_manager_h	handle,
		const char *	pattern
	)

Sets the required password pattern.

Warning:: This is not for use by third-party applications.

An administrator can force User to enter password based on a regular expression.

Since :: 3.0

Privilege Level:: partner

Privilege:: http://tizen.org/privilege/dpm.password

Parameters:

[in]	handle	Device policy manager handle
[in]	pattern	Password pattern. If regular expression is [a-zA-Z]{4}[0-9]{4}, we can force user to enter a 8 character password with first 4 alphabetic characters and next 4 numeric characters. An administrator must take care when setting this pattern.

Returns:: DPM_ERROR_NONE on success, otherwise a negative value

Return values:

DPM_ERROR_NONE	Successful
DPM_ERROR_INVALID_PARAMETER	Invalid parameter
DPM_ERROR_TIMED_OUT	Time out
DPM_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this API

Precondition:: The handle must be created by dpm_manager_create().

See also:: dpm_manager_create()

int dpm_password_set_quality	(	device_policy_manager_h	handle,
		int	quality
	)

Sets password quality.

Warning:: This is not for use by third-party applications.

An administrator can set the password restrictions it is imposing. After setting this, the user will not be able to enter a new password that is not at least as restrictive as what has been set.

Since :: 3.0

Privilege Level:: partner

Privilege:: http://tizen.org/privilege/dpm.password

Parameters:

[in]	handle	Device policy manager handle
[in]	quality	Password quality type, values of dpm_password_quality_e combined with bitwise 'or'

Returns:: DPM_ERROR_NONE on success, otherwise a negative value

Return values:

DPM_ERROR_NONE	Successful
DPM_ERROR_INVALID_PARAMETER	Invalid parameter
DPM_ERROR_TIMED_OUT	Time out
DPM_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this API

Precondition:: The handle must be created by dpm_manager_create().

See also:: dpm_manager_create()

int dpm_password_set_status	(	device_policy_manager_h	handle,
		dpm_password_status_e	status
	)

Sets password status.

Warning:: This is not for use by third-party applications.

An administrator can know password status for this API.

Since :: 3.0

Privilege Level:: partner

Privilege:: http://tizen.org/privilege/dpm.password

Parameters:

[in]	handle	Device policy manager handle
[in]	status	Password status

Returns:: DPM_ERROR_NONE on success, otherwise a negative value

Return values:

DPM_ERROR_NONE	Successful
DPM_ERROR_INVALID_PARAMETER	Invalid parameter
DPM_ERROR_TIMED_OUT	Time out
DPM_ERROR_PERMISSION_DENIED	The application does not have the privilege to call this API

Precondition:: The handle must be created by dpm_manager_create().

See also:: dpm_manager_create()

Required Header

Overview

Functions

Typedefs

Typedef Documentation

Enumeration Type Documentation

Function Documentation