Función CertSrvBackupGetBackupLogsW (certbcli.h)
La función CertSrvBackupGetBackupLogs recupera la lista de nombres de archivo de registro de Servicios de certificados de los que se debe realizar una copia de seguridad para el contexto de copia de seguridad especificado.
Sintaxis
HRESULT CERTBCLI_API CertSrvBackupGetBackupLogsW(
[in] HCSBC hbc,
[out] PWSTR *ppwszzBackupLogFiles,
[out] DWORD *pcbSize
);
Parámetros
[in] hbc
Identificador de un contexto de copia de seguridad de Servicios de certificados.
[out] ppwszzBackupLogFiles
Puntero al puntero WCHAR que recibirá la lista de nombres de archivo de registro terminados en null. Hay un carácter NULO después de cada nombre de archivo y un carácter nulo adicional al final de la lista. El nombre de archivo estará en el formato UNC "## \\Server\SharePoint\... Path...\FileName.ext". Los nombres de directorio tendrán el mismo formato, pero sin el final "\FileName.ext". El texto "##" indica un tipo de archivo de copia de seguridad de Servicios de certificados (CSBFT_*) y se almacena como un único carácter Unicode no NULL con el prefijo de cada ruta de acceso UNC. Esta etiqueta de tipo se define en Certbcli.h y puede ser uno de los siguientes valores para esta función.
Cuando haya terminado de usar esta memoria asignada, ábrela llamando a la función CertSrvBackupFree .
Establecer ppwszzBackupLogFiles en NULL antes de llamar a esta función es opcional.
[out] pcbSize
Puntero al valor DWORD que especifica el número de bytes en ppwszzBackupLogFiles.
Valor devuelto
El valor devuelto es un HRESULT. Un valor de S_OK indica que se ha realizado correctamente.
Comentarios
Los archivos de registro representan la actividad de la base de datos (envíos de solicitudes, revocación de certificados, etc.) que se ha producido desde el último truncamiento del archivo de registro. El volumen del archivo de registro aumenta a medida que se produce la actividad de la base de datos. Los archivos de registro se pueden reducir en tamaño realizando una copia de seguridad y llamando a CertSrvBackupTruncateLogs.
El nombre de esta función en el Certadm.dll es CertSrvBackupGetBackupLogsW. Debe usar este formato del nombre al llamar a GetProcAddress. Además, esta función se define como el tipo FNCERTSRVBACKUPGETBACKUPLOGSW en el archivo de encabezado Certbcli.h.
Ejemplos
FNCERTSRVBACKUPGETBACKUPLOGSW* pfnGetBackupLogs;
char * szGetBackupLogsFunc = "CertSrvBackupGetBackupLogsW";
WCHAR * pwszzLogFiles;
DWORD nListBytes=0;
HRESULT hr=0;
// Get the address for the desired function.
// hInst was set by calling LoadLibrary for Certadm.dll.
pfnGetBackupLogs = (FNCERTSRVBACKUPGETBACKUPLOGSW*)GetProcAddress
(hInst, szGetBackupLogsFunc);
if ( NULL == pfnGetBackupLogs )
{
printf("Failed GetProcAddress - %s, error=%d\n",
szGetBackupLogsFunc,
GetLastError() );
exit(1); // Or other appropriate error action.
}
// Determine the names of the log files.
// hCSBC was set by an earlier call to CertSrvbackupPrepare.
hr = pfnGetBackupLogs(hCSBC, &pwszzLogFiles, &nListBytes);
if (FAILED(hr))
{
printf("Failed pfnGetBackupLogs call [%x]\n", hr);
exit(1); // Or other appropriate error action.
}
else
{
printf("%d bytes for log file names\n", nListBytes);
WCHAR * pwszLog = pwszzLogFiles;
// Process the list.
while ( L'\0' != *pwszLog )
{
// Use the file name referenced by pwszLog.
// Here it is merely displayed.
printf("%02x: %ws\n", *pwszLog, &pwszLog[1]);
// Move to the next logfile name.
// + 1 moves past the null terminator.
pwszLog+=(wcslen(pwszLog)) + 1;
}
// Free the allocated memory.
// pfnBackupFree is the address of the CertSrvBackupFree
// function.
pfnBackupFree(pwszzLogFiles);
}
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | No se admite ninguno |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | certbcli.h (incluya Certsrv.h) |
| Library | Certadm.lib |
| Archivo DLL | Certadm.dll |
Consulte también
Uso de las funciones de copia de seguridad y restauración de Servicios de certificados