VLScpdCreateObject

Syntax

int VLScpdCreateObject(	 	 
int	 	iPersistType,
char	 	*pcErrorInfoOut ;

Argument	Direction	Data Type	Description
iPersistType	IN	int	Type of persistence device. Refer to Persistence Types section for more information.
pcErrorInfoOut	OUT	char*	See Using the Diagnostic Information.

Description

This API should be used for creating persistence objects for different persistence types. The object creation process depends upon the persistence device in use. For more information on managing the persistence data storage, see Deciding the Persistence Data Storage Strategy.

This callback will be called multiple times (as required) for each persistence type by License Manager or the client application.

The Implementation of this API must not overwrite the existing objects to prevent loss of persistence data. The developer’s implementation should:

>Create a new object only when an existing object is not available.

>Return VLS_CPD_OBJECT_ALREADY_EXISTS error when an existing object is available.

Returns

This status code VLS_CPD_SUCCESS is returned if successful. Otherwise, it will return one of the following errors codes:

Error Code	Description
VLS_CPD_BAD_INPUT	Arguments are not defined as per the specification of this API.
VLS_CPD_DEVICE_NO_PERM	Insufficient permissions.
VLS_CPD_DEVICE_FATAL_ERROR	Read/write failure or any other error.
VLS_CPD_OBJECT_ALREADY_EXISTS	An object or a record for the selected persistence type already exists.