vitasdk
Documentation of the vitasdk
Functions
User
Miscellaneous » Promoter utility

Detailed Description

Exports for User.

Using this library in your project

Include the header file in your project:

#include <psp2/promoterutil.h>


Link the library to the executable:

ScePromoterUtil_stub


Functions

 VITASDK_BUILD_ASSERT_EQ (0x8C, ScePromoterUtilityLAUpdate)
 
 VITASDK_BUILD_ASSERT_EQ (0xB0, ScePromoterUtilityImportParams)
 
int scePromoterUtilityInit (void)
 Init the promoter utility. More...
 
int scePromoterUtilityExit (void)
 Deinit the promoter utility. More...
 
int scePromoterUtilityDeletePkg (const char *titleid)
 Delete a package from the LiveArea. More...
 
int scePromoterUtilityUpdateLiveArea (ScePromoterUtilityLAUpdate *args)
 Update the LiveArea resources of an app. More...
 
int scePromoterUtilityPromoteImport (ScePromoterUtilityImportParams *params)
 Install Content Manager import contents and create bubbles without checking license files. More...
 
int scePromoterUtilityPromotePkg (const char *path, int sync)
 Install a package from a directory, and add an icon on the LiveArea. More...
 
int scePromoterUtilityPromotePkgWithRif (const char *path, int sync)
 Install a package from a directory and generate a rif. More...
 
int scePromoterUtilityGetState (int *state)
 Returns the state of an operation. More...
 
int scePromoterUtilityGetResult (int *res)
 Returns the result of a finished operation. More...
 
int scePromoterUtilityCheckExist (const char *titleid, int *res)
 Check if titleid exists. More...
 

Data Structure Documentation

◆ ScePromoterUtilityLAUpdate

struct ScePromoterUtilityLAUpdate

Parameters for scePromoterUtilityUpdateLiveArea()

Data Fields
char titleid[12] Target app.
char path[128] Directory of extracted LA update data.

◆ ScePromoterUtilityImportParams

struct ScePromoterUtilityImportParams

Parameters for scePromoterUtilityPromoteImport()

Data Fields
char path[0x80] Install path (ux0:/temp/game on PSM/PSV, ux0:/pspemu/temp/game on PSP)
char titleid[0xC] Game titleid.
ScePromoterUtilityPackageType type Package type.
uint32_t attribute Additional Attributes (Appears to be 0x1 on PSM content but 0x00 on Vita contents)
char reserved[0x1C]

Enumeration Type Documentation

◆ ScePromoterUtilityPackageType

enum ScePromoterUtilityPackageType

Avalible types for ScePromoterUtilityImportParams.

Enumerator
SCE_PKG_TYPE_VITA 

PSVita Apps.

SCE_PKG_TYPE_PSP 

PSP Games.

SCE_PKG_TYPE_PSM 

PlayStation Mobile.

Function Documentation

◆ VITASDK_BUILD_ASSERT_EQ() [1/2]

VITASDK_BUILD_ASSERT_EQ ( 0x8C  ,
ScePromoterUtilityLAUpdate   
)

◆ VITASDK_BUILD_ASSERT_EQ() [2/2]

VITASDK_BUILD_ASSERT_EQ ( 0xB0  ,
ScePromoterUtilityImportParams   
)

◆ scePromoterUtilityInit()

int scePromoterUtilityInit ( void  )

Init the promoter utility.

Note
Needs to be called before using the other functions.
Returns
0 on success.

◆ scePromoterUtilityExit()

int scePromoterUtilityExit ( void  )

Deinit the promoter utility.

Returns
0 on success.

◆ scePromoterUtilityDeletePkg()

int scePromoterUtilityDeletePkg ( const char *  titleid)

Delete a package from the LiveArea.

Parameters
[in]*titleid
Returns
0 on success.

◆ scePromoterUtilityUpdateLiveArea()

int scePromoterUtilityUpdateLiveArea ( ScePromoterUtilityLAUpdate *  args)

Update the LiveArea resources of an app.

Parameters
[in]*args- see ScePromoterUtilityLAUpdate
Returns
0 on success.

◆ scePromoterUtilityPromoteImport()

int scePromoterUtilityPromoteImport ( ScePromoterUtilityImportParams *  params)

Install Content Manager import contents and create bubbles without checking license files.

Parameters
[in]*params- see ::ScePromoterUtilImportParams
Returns
0 on success.

◆ scePromoterUtilityPromotePkg()

int scePromoterUtilityPromotePkg ( const char *  path,
int  sync 
)

Install a package from a directory, and add an icon on the LiveArea.

Parameters
[in]*path- the path of the directory where the extracted content of the package is
sync- pass 0 for asynchronous, 1 for synchronous
Returns
0 on success.

◆ scePromoterUtilityPromotePkgWithRif()

int scePromoterUtilityPromotePkgWithRif ( const char *  path,
int  sync 
)

Install a package from a directory and generate a rif.

Parameters
[in]*path- the path of the directory where the extracted content of the package is
sync- pass 0 for asynchronous, 1 for synchronous
Returns
0 on success.

◆ scePromoterUtilityGetState()

int scePromoterUtilityGetState ( int *  state)

Returns the state of an operation.

Parameters
[out]*state- the current status, 0 when finished
Returns
< 0 if failed.

◆ scePromoterUtilityGetResult()

int scePromoterUtilityGetResult ( int *  res)

Returns the result of a finished operation.

Parameters
[out]*res- the result, 0 on success
Returns
< 0 if failed.

◆ scePromoterUtilityCheckExist()

int scePromoterUtilityCheckExist ( const char *  titleid,
int *  res 
)

Check if titleid exists.

Parameters
[out]*res- the result, unknown meaning
Returns
0 if exists, < 0 otherwise.