USB Exported Control API > BS2_GetUserListFromDirWithKey


[+2.8.2] Import registered user identifiers from USB extracted data into an array.

Declaration

#include "BS_API.h"
 
int BS2_GetUserListFromDirWithKey(void* context, const char* szDir, char** uidsObj, uint32_t* numUid, IsAcceptableUserID ptrIsAcceptableUserID, const BS2EncryptKey* key);

Parameters

  • [In] context : Context
  • [Out] szDir : Data storage path
  • [Out] uidsObjs : Pointer to store addresses in the user identifier list
  • [Out] numUid : Total number of users
  • [In] ptrIsAcceptableUserID : callback function to ask the server if it is the user ID to allow
  • [In] key : Encryption key and the key value specified by BS2_SetDataEncryptKey

Note
The uidsObjs variable must return memory to the system after using via the BS2_ReleaseObject function.

Return value

Returns BS_SDK_SUCCESS if performed successfully, or a corresponding error code if an error occurs.

See Also