CertSrvBackupGetDynamicFileListW 函数 (certbcli.h)
CertSrvBackupGetDynamicFileList 函数检索需要为给定备份上下文备份的证书服务动态文件名列表。 动态文件是证书服务数据库备份中未包含的文件。
语法
HRESULT CERTBCLI_API CertSrvBackupGetDynamicFileListW(
[in] HCSBC hbc,
[out] PWSTR *ppwszzFileList,
[out] DWORD *pcbSize
);
参数
[in] hbc
证书服务备份上下文的句柄。
[out] ppwszzFileList
指向 WCHAR 指针的指针,该指针将接收证书服务使用的以 null 结尾的动态文件名的列表。 每个文件名后都有一个空字符,列表末尾有一个额外的 null 字符。 文件名将采用 UNC 格式“\\Server\SharePoint\...Path...\FileName.ext”。 使用此分配的内存后,通过调用 CertSrvBackupFree 函数释放它。
在调用此函数之前,将 *ppwszzFileList 设置为 NULL 是可选的。
[out] pcbSize
指向 DWORD 值的指针,该值指定 ppwszzFileList 中的字节数。
返回值
返回值为 HRESULT。 值为 S_OK 表示成功。
注解
使用此函数检索证书服务动态文件名的列表。 这些文件独立于证书服务数据库和日志文件,它们不由证书服务备份 API 进行备份。 因此,必须使用其他一些方法来备份动态文件。 证书服务动态文件的一个示例是证书 吊销列表 (CRL) 。
Certadm.dll 中此函数的名称为 CertSrvBackupGetDynamicFileListW。 调用 GetProcAddress 时,必须使用此形式的名称。 此外,此函数在 Certbcli.h 头文件中定义为类型 FNCERTSRVBACKUPGETDYNAMICFILELISTW 。
示例
FNCERTSRVBACKUPGETDYNAMICFILELISTW* pfnGetDynFiles;
char * szGetDynFilesFunc = "CertSrvBackupGetDynamicFileListW";
WCHAR * pwszzDynFiles;
DWORD nListBytes=0;
HRESULT hr=0;
// Get the address for the desired function.
// hInst was set by calling LoadLibrary for Certadm.dll.
pfnGetDynFiles = (FNCERTSRVBACKUPGETDYNAMICFILELISTW*)
GetProcAddress(hInst, szGetDynFilesFunc);
if ( NULL == pfnGetDynFiles )
{
printf("Failed GetProcAddress - %s, error=%d\n",
szGetDynFilesFunc,
GetLastError() );
exit(1); // Or other appropriate error action.
}
// Determine the names of the dynamic files.
// hCSBC was set by an earlier call to CertSrvBackupPrepare.
hr = pfnGetDynFiles(hCSBC, &pwszzDynFiles, &nListBytes);
if (FAILED(hr))
{
printf("Failed pfnGetDynFiles call [%x]\n", hr);
exit(1); // Or other appropriate error action.
}
else
{
printf("%d bytes for dynamic file names\n", nListBytes);
WCHAR * pwszFile = pwszzDynFiles;
// Process the list.
while ( L'\0' != *pwszFile )
{
// Use the file name referenced by pwszFile.
// Here it is merely displayed.
printf("%ws\n", pwszFile);
// Move to the next dynamic file name.
// + 1 moves past the null terminator.
pwszFile+=(wcslen(pwszFile)) + 1;
}
// Free the allocated memory.
// pfnBackupFree is the address of the
// CertSrvBackupFree function.
pfnBackupFree(pwszzDynFiles);
}
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 无受支持的版本 |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | certbcli.h (包括 Certsrv.h) |
Library | Certadm.lib |
DLL | Certadm.dll |