7.3 應用管理

7.3 應用管理

7.3.1　概述

應用管理主要完成應用的創建、枚舉、刪除、打開、關閉等操作。應用管理系列函數如表18所示：

表18 應用管理系列函數

7.3.2　創建應用

原型 ULONG DEVAPI SKF_CreateApplication(DEVHANDLE hDev, LPSTR szAppName, LPSTR szAdminPin, DWORD dwAdminPinRetryCount,LPSTR szUserPin, DWORD dwUserPinRetryCount,DWORD dwCreateFileRights, HAPPLICATION *phApplication)
功能描述 創建一個應用。
參數 hDev [IN] 連接設備時返回的設備句柄。
szAppName [IN] 應用名稱。
szAdminPin [IN] 管理員PIN。
dwAdminPinRetryCount [IN] 管理員PIN最大重試次數。
szUserPin [IN] 用戶PIN。
dwUserPinRetryCount [IN] 用戶PIN最大重試次數。
dwCreateFileRights [IN] 在該應用下創建文件和容器的權限，參見6.4.9權限類型。為各種權限的或值。
phApplication [OUT] 應用的句柄。
返回值 SAR_OK： 成功。
其他： 錯誤碼。

7.3.3　枚舉應用

原型 ULONG DEVAPI SKF_EnumApplication(DEVHANDLE hDev, LPSTR szAppName,ULONG *pulSize)
功能描述 枚舉設備中存在的所有應用。
參數 hDev [IN] 連接設備時返回的設備句柄。
szAppName [OUT] 返回應用名稱列表, 如果該參數為空，將由pulSize返回所需要的內存空間大小。每個應用的名稱以單個‘\0’結束，以雙‘\0’表示列表的結束。
pulSize
[IN，OUT] 輸入時表示應用名稱的緩沖區長度，輸出時返回szAppName所占用的空間大小。
返回值 SAR_OK： 成功。

7.3.4　刪除應用

原型 ULONG DEVAPI SKF_DeleteApplication(DEVHANDLE hDev, LPSTR szAppName)
功能描述 刪除指定的應用。
參數 hDev [IN] 連接設備時返回的設備句柄。
szAppName [IN] 應用名稱。
返回值 SAR_OK： 成功。
其他： 錯誤碼。

7.3.5　打開應用

原型 ULONG DEVAPI SKF_OpenApplication(DEVHANDLE hDev, LPSTR szAppName, HAPPLICATION *phApplication)
功能描述 打開指定的應用。
參數 hDev [IN] 連接設備時返回的設備句柄。
szAppName [IN] 應用名稱。
phApplication [OUT] 應用的句柄。
返回值 SAR_OK： 成功。

7.3.6　關閉應用

原型 ULONG DEVAPI SKF_CloseApplication(HAPPLICATION hApplication)
功能描述 關閉應用并釋放應用句柄。
參數 hApplication [IN]應用句柄。
返回值 SAR_OK： 成功。
其他： 錯誤碼。