CertSrvBackupGetDynamicFileListW-Funktion (certbcli.h)

Artikel
02/23/2024

Die CertSrvBackupGetDynamicFileList-Funktion ruft die Liste der dynamischen Dateinamen von Certificate Services ab, die für den angegebenen Sicherungskontext gesichert werden müssen. Die dynamischen Dateien sind diejenigen, die nicht in der Zertifikatdienste-Datenbanksicherung enthalten sind.

Syntax

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

Parameter

[in] hbc

Ein Handle für einen Zertifikatdienste-Sicherungskontext.

[out] ppwszzFileList

Ein Zeiger auf einen WCHAR-Zeiger , der die Liste der dynamischen Dateinamen mit NULL-Beendigung empfängt, die von Zertifikatdiensten verwendet werden. Hinter jedem Dateinamen befindet sich ein NULL-Zeichen und ein zusätzliches NULL-Zeichen am Ende der Liste. Der Dateiname hat das UNC-Format "\\Server\SharePoint\... Path...\FileName.ext". Wenn Sie diesen zugewiesenen Arbeitsspeicher verwendet haben, geben Sie ihn frei, indem Sie die CertSrvBackupFree-Funktion aufrufen.

Vor dem Aufrufen dieser Funktion ist das Festlegen von *ppwszzFileList auf NULL optional.

[out] pcbSize

Ein Zeiger auf den DWORD-Wert , der die Anzahl der Bytes in ppwszzFileList angibt.

Rückgabewert

Der Rückgabewert ist ein HRESULT. Ein Wert von S_OK gibt den Erfolg an.

Hinweise

Verwenden Sie diese Funktion, um eine Liste der dynamischen Dateinamen von Certificate Services abzurufen. Diese Dateien sind von der Zertifikatdienste-Datenbank und den Protokolldateien getrennt und werden nicht durch die Zertifikatdienste-Sicherungs-APIs gesichert. Daher müssen einige andere Mittel zum Sichern der dynamischen Dateien verwendet werden. Ein Beispiel für eine dynamische Certificate Services-Datei ist die Zertifikatsperrliste (Certificate Revocation List , CRL).

Der Name dieser Funktion im Certadm.dll lautet CertSrvBackupGetDynamicFileListW. Sie müssen diese Form des Namens verwenden, wenn Sie GetProcAddress aufrufen. Außerdem wird diese Funktion als Typ FNCERTSRVBACKUPGETDYNAMICFILELISTW in der Headerdatei Certbcli.h definiert.

Beispiele

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	certbcli.h (include Certsrv.h)
Bibliothek	Certadm.lib
DLL	Certadm.dll

Weitere Informationen

CertSrvBackupFree

Verwenden der Sicherungs- und Wiederherstellungsfunktionen für Zertifikatdienste

Freigeben über