CertSrvBackupGetBackupLogsW-Funktion (certbcli.h)

Artikel
02/26/2024

Die CertSrvBackupGetBackupLogs-Funktion ruft die Liste der Zertifikatdienste-Protokolldateinamen ab, die für den angegebenen Sicherungskontext gesichert werden müssen.

Syntax

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

Parameter

[in] hbc

Ein Handle für einen Sicherungskontext für Zertifikatdienste.

[out] ppwszzBackupLogFiles

Ein Zeiger auf den WCHAR-Zeiger , der die Liste der Mit NULL beendeten Protokolldateinamen empfängt. 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". Die Verzeichnisnamen haben dieselbe Form, aber ohne den nachfolgenden "\FileName.ext". Der Text "##" bezeichnet einen Sicherungsdateityp für Zertifikatdienste (CSBFT_*) und wird als einzelnes Unicode-Zeichen ungleich NULL gespeichert, das jedem UNC-Pfad vorangestellt ist. Dieses Typtag ist in Certbcli.h definiert und kann einer der folgenden Werte für diese Funktion sein.

Wert	Bedeutung
CSBFT_LOG	Name der Zertifikatdienste-Datenbankprotokolldatei einschließlich Pfad.
CSBFT_PATCH_FILE	Der Name, einschließlich des Pfads, der Updatedatei für die Zertifikatdienste-Datenbank. Windows Server 2003: Datenbankupdatedateien werden nicht verwendet.

Wenn Sie diesen zugeordneten Arbeitsspeicher nicht mehr verwendet haben, geben Sie ihn frei, indem Sie die CertSrvBackupFree-Funktion aufrufen.

Das Festlegen von ppwszzBackupLogFiles auf NULL vor dem Aufrufen dieser Funktion ist optional.

[out] pcbSize

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

Rückgabewert

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

Hinweise

Die Protokolldateien stellen die Datenbankaktivität (Anforderungsübermittlungen, Zertifikatsperrung usw.) dar, die seit dem letzten Abschneiden der Protokolldatei aufgetreten ist. Das Protokolldateivolume nimmt zu, wenn die Datenbankaktivität auftritt. Die Größe der Protokolldateien kann verringert werden, indem sie eine Sicherung durchführen und dann CertSrvBackupTruncateLogs aufrufen.

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

Beispiele

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

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 (certsrv.h einschließen)
Bibliothek	Certadm.lib
DLL	Certadm.dll