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

See also

CertSrvBackupGetBackupLogs

CertSrvBackupGetDatabaseNames

CertSrvBackupGetDynamicFileList

CertSrvRestoreGetDatabaseLocations

CertSrvServerControl

Using the Certificate Services Backup and Restore Functions