Funzione CertSrvBackupGetDynamicFileListW (certbcli.h)

Articolo
08/22/2023

La funzione CertSrvBackupGetDynamicFileList recupera l'elenco dei nomi di file dinamici di Servizi certificati che devono essere sottoposti a backup per il contesto di backup specificato. I file dinamici sono quelli che non sono inclusi nel backup del database di Servizi certificati.

Sintassi

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

Parametri

[in] hbc

Handle in un contesto di backup di Servizi certificati.

[out] ppwszzFileList

Puntatore a un puntatore WCHAR che riceverà l'elenco di nomi di file dinamici con terminazione null usati da Servizi certificati. È presente un carattere Null dopo ogni nome di file e un carattere null aggiuntivo alla fine dell'elenco. Il nome del file sarà nel formato UNC "\\Server\SharePoint\... Path...\FileName.ext". Al termine dell'uso di questa memoria allocata, liberarla chiamando la funzione CertSrvBackupFree .

Prima di chiamare questa funzione, l'impostazione di *ppwszzFileList su NULL è facoltativa.

[out] pcbSize

Puntatore al valore DWORD che specifica il numero di byte in ppwszzFileList.

Valore restituito

Il valore restituito è un HRESULT. Un valore di S_OK indica l'esito positivo.

Commenti

Usare questa funzione per recuperare un elenco dei nomi di file dinamici di Servizi certificati. Questi file sono separati dal database e dai file di log di Servizi certificati e non vengono sottoposti a backup dalle API di backup di Servizi certificati. Di conseguenza, alcuni altri mezzi devono essere usati per eseguire il backup dei file dinamici. Un esempio di file dinamico di Servizi certificati è l'elenco di revoche di certificati (CRL).

Il nome della funzione nel Certadm.dll è CertSrvBackupGetDynamicFileListW. È necessario usare questo formato del nome quando si chiama GetProcAddress. Questa funzione viene inoltre definita come tipo FNCERTSRVBACKUPGETDYNAMICFILELISTW nel file di intestazione Certbcli.h.

Esempio

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

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	certbcli.h (includere Certsrv.h)
Libreria	Certadm.lib
DLL	Certadm.dll

Vedi anche

CertSrvBackupFree

Uso delle funzioni di backup e ripristino dei servizi certificati

Condividi tramite