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.

Valor	Significado
CSBFT_LOG	Nombre del archivo de registro de base de datos de Certificate Services, incluida la ruta de acceso.
CSBFT_PATCH_FILE	Nombre, incluida la ruta de acceso, del archivo de actualización de la base de datos de Servicios de certificados. Windows Server 2003: No se usan archivos de actualización de base de datos.

 

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

CertSrvBackupFree

CertSrvBackupOpenFile

CertSrvBackupTruncateLogs

Uso de las funciones de copia de seguridad y restauración de Servicios de certificados