Función CertSrvBackupGetDynamicFileListW (certbcli.h)

La función CertSrvBackupGetDynamicFileList recupera la lista de nombres de archivo dinámicos de Servicios de certificados de los que se debe realizar una copia de seguridad para el contexto de copia de seguridad especificado. Los archivos dinámicos son aquellos que no se incluyen en la copia de seguridad de la base de datos de Servicios de certificados.

Sintaxis

HRESULT CERTBCLI_API CertSrvBackupGetDynamicFileListW(
  [in]  HCSBC hbc,
  [out] PWSTR *ppwszzFileList,
  [out] DWORD *pcbSize
);

Parámetros

[in] hbc

Identificador de un contexto de copia de seguridad de Servicios de certificados.

[out] ppwszzFileList

Puntero a un puntero WCHAR que recibirá la lista de nombres de archivo dinámicos terminados en null usados por Servicios de certificados. 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". Cuando haya terminado de usar esta memoria asignada, liberela llamando a la función CertSrvBackupFree .

Antes de llamar a esta función, establecer *ppwszzFileList en NULL es opcional.

[out] pcbSize

Puntero al valor DWORD que especifica el número de bytes en ppwszzFileList.

Valor devuelto

El valor devuelto es hrESULT. Un valor de S_OK indica que se ha realizado correctamente.

Comentarios

Use esta función para recuperar una lista de los nombres de archivo dinámicos de Servicios de certificados. Estos archivos son independientes de la base de datos de Servicios de certificados y de los archivos de registro, y no las realiza la copia de seguridad de las API de copia de seguridad de Servicios de certificados. Como resultado, se deben usar otros medios para realizar copias de seguridad de los archivos dinámicos. Un ejemplo de un archivo dinámico de Servicios de certificados es la lista de revocación de certificados (CRL).

El nombre de esta función en el Certadm.dll es CertSrvBackupGetDynamicFileListW. Debe usar este formato del nombre al llamar a GetProcAddress. Además, esta función se define como tipo FNCERTSRVBACKUPGETDYNAMICFILELISTW en el archivo de encabezado Certbcli.h.

Ejemplos

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);
}

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

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