7.5 容器管理

7.5 容器管理

7.5.1　概述

本標準提供的應用管理用于滿足各種不同應用的管理，包括創建、刪除、枚舉、打開和關閉容器的操作。容器管理系列函數如表20所示：

表20 容器管理系列函數

7.5.2　創建容器

原型 ULONG DEVAPI SKF_CreateContainer (HAPPLICATION hApplication, LPSTR szContainerName, HCONTAINER *phContainer)
功能描述 在應用下建立指定名稱的容器并返回容器句柄。
參數 hApplication [IN]應用句柄。
szContainerName [IN] ASCII字符串，表示所建立容器的名稱，容器名稱的最大長度不能超過64字節。
phContainer [OUT] 返回所建立容器的容器句柄。
返回值 SAR_OK： 成功。
其他： 錯誤碼。

7.5.3　刪除容器

原型 ULONG DEVAPI SKF_DeleteContainer(HAPPLICATION hApplication, LPSTR szContainerName)
功能描述 在應用下刪除指定名稱的容器并釋放容器相關的資源。
參數 hApplication [IN]應用句柄。
szContainerName [IN] 指向刪除容器的名稱。
返回值 SAR_OK： 成功。
其他： 錯誤碼。

7.5.4　打開容器

原型 ULONG DEVAPI SKF_OpenContainer(HAPPLICATION hApplication,LPSTR szContainerName,HCONTAINER *phContainer)
功能描述 獲取容器句柄。
參數 hApplication [IN]應用句柄。
szContainerName [IN] 容器的名稱。
phContainer [OUT] 返回所打開容器的句柄。
返回值 SAR_OK： 成功。

7.5.5　關閉容器

原型 ULONG DEVAPI SKF_CloseContainer(HCONTAINER hContainer)
功能描述 關閉容器句柄，并釋放容器句柄相關資源。
參數 hContainer [IN] 容器句柄。
返回值 SAR_OK： 成功。

7.5.6　枚舉容器

原型 ULONG DEVAPI SKF_EnumContainer (HAPPLICATION hApplication, LPSTR szContainerName, ULONG *pulSize)
功能描述 枚舉容器下所有容器并返回容器名稱列表
參數 hApplication [IN]應用句柄。

pulSize [OUT]指向容器名稱列表緩沖區，如果此參數為NULL時，pulSize表示返回數據所需緩存區的長度，如果此參數不為NULL時，返回容器名稱列表，每個容器名以‘\0’為結束，列表以雙‘\0’結束。
[IN,OUT]輸入時表示szContainerName緩存區的長度，輸出時表示容器名稱列表的長度。
返回值 SAR_OK： 成功。

7.5.7　獲得容器類型

原型 ULONG DEVAPI SKF_GetContainerType(HCONTAINER hContainer, ULONG *pulContainerType)
功能描述 獲取容器的類型
參數 hContainer [IN]容器句柄。
pulContainerType [OUT] 獲得的容器類型。指針指向的值為0表示未定、尚未分配類型或者為空容器，為1表示為RSA容器，為2表示為SM2容器。
返回值 SAR_OK： 成功。

7.5.8　導入數字證書

原型 ULONG DEVAPI SKF_ImportCertificate(HCONTAINER hContainer, BOOL bSignFlag, BYTE* pbCert, ULONG ulCertLen)
功能描述 向容器內導入數字證書。
參數 hContainer [IN]容器句柄。
bSignFlag [IN] TRUE表示簽名證書，FALSE表示加密證書。
pbCert [IN] 指向證書內容緩沖區。
ulCertLen [IN] 證書長度。
返回值 SAR_OK： 成功。

7.5.9　導出數字證書

原型 ULONG DEVAPI SKF_ExportCertificate(HCONTAINER hContainer, BOOL bSignFlag, BYTE* pbCert, ULONG *pulCertLen)
功能描述 從容器內導出數字證書。
參數 hContainer [IN]容器句柄。
bSignFlag [IN] TRUE表示簽名證書，FALSE表示加密證書。
pbCert [OUT] 指向證書內容緩沖區，如果此參數為NULL時，pulCertLen表示返回數據所需要緩沖區的長度，如果此參數不為NULL時，返回數字證書內容。
pulCertLen [IN/OUT] 輸入時表示pbCert緩沖區的長度，輸出時表示證書內容的長度。
返回值 SAR_OK： 成功。