CertSrvBackupFree function (certbcli.h)
The CertSrvBackupFree function is used to free memory allocated from certain Certificate Services Backup APIs.
Syntax
VOID CERTBCLI_API CertSrvBackupFree(
[in] VOID *pv
);
Parameters
[in] pv
A pointer to the memory to be freed.
Return value
This function does not return a value.
Remarks
Call this function when finished with memory allocated by using the following functions:
- CertSrvBackupGetBackupLogs
- CertSrvBackupGetDatabaseNames
- CertSrvBackupGetDynamicFileList
- CertSrvServerControl
- CertSrvRestoreGetDatabaseLocations
Examples
FNCERTSRVBACKUPFREE* pfnBackupFree;
char * szBackupFreeFunc = "CertSrvBackupFree";
// Get the address for the desired function.
// hInst was set by calling LoadLibrary for Certadm.dll.
pfnBackupFree = (FNCERTSRVBACKUPFREE*)GetProcAddress(hInst,
szBackupFreeFunc);
if ( NULL == pfnBackupFree )
{
printf("Failed GetProcAddress - %s, error=%d\n",
szBackupFreeFunc,
GetLastError() );
exit(1);
}
// Use the backup APIs.
// ...
// Free allocated memory.
// pBuff was allocated by another certsrv backup function.
pfnBackupFree(pBuff);
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | None supported |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Target Platform | Windows |
| Header | certbcli.h (include Certsrv.h) |
| Library | Certadm.lib |
| DLL | Certadm.dll |
See also
CertSrvBackupGetDynamicFileList