Funzione CertSrvBackupOpenFileW (certbcli.h)

Articolo
08/22/2023

La funzione CertSrvBackupOpenFile apre un file per il backup.

Sintassi

HRESULT CERTBCLI_API CertSrvBackupOpenFileW(
  [in]  HCSBC         hbc,
  [in]  WCHAR const   *pwszAttachmentName,
  [in]  DWORD         cbReadHintSize,
  [out] LARGE_INTEGER *pliFileSize
);

Parametri

[in] hbc

Handle per un contesto di backup di Servizi certificati .

[in] pwszAttachmentName

Nome file da aprire a scopo di backup. Questo nome file verrà analizzato da un elenco prodotto tramite CertSrvBackupGetBackupLogs o CertSrvBackupGetDatabaseNames. Si noti che i nomi restituiti da CertSrvBackupGetBackupLogs e CertSrvBackupGetDatabaseNames devono avere il prefisso single-WCHAR CSBFT_* rimosso prima della chiamata a CertSrvBackupOpenFile .

[in] cbReadHintSize

Numero di byte usati come hint quando il file viene letto da CertSrvBackupRead. Il parametro cbReadHintSize passato alla prima chiamata CertSrvBackupOpenFile per il contesto di backup viene usato per ridimensionare il buffer di lettura. Passare zero per questo parametro e il buffer verrà ridimensionato a una dimensione ragionevolmente efficiente scelta da CertSrvBackupOpenFile. Se è disponibile memoria insufficiente, le dimensioni del buffer verranno ridotte fino a quando l'allocazione della memoria non riesce o fino a quando le dimensioni del buffer non raggiungono il valore minimo possibile. Passare una dimensione diversa da zero per fare in modo che CertSrvBackupOpenFile ridimensiona il buffer a una potenza di due vicino al valore di cbReadHintSize. L'implementazione sceglierà solo due poteri compresi tra 64 KB e 4 MB.

[out] pliFileSize

Puntatore a un valore LARGE_INTEGER che rappresenta il numero di byte nel file.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce S_OK.

Se la funzione ha esito negativo, restituisce un valore HRESULT che indica l'errore. Per un elenco dei codici di errore comuni, vedere Valori HRESULT comuni.

Commenti

Usare questa funzione per aprire un file a scopo di backup. Al termine dell'uso del file, chiudere il file chiamando la funzione CertSrvBackupClose .

Il nome di questa funzione in Certadm.dll è CertSrvBackupOpenFileW. È necessario utilizzare questo formato del nome quando si chiama GetProcAddress. Questa funzione è definita anche come tipo FNCERTSRVBACKUPOPENFILEW in Certbcli.h.

Esempio

FNCERTSRVBACKUPOPENFILEW* pfnOpenFile;
char * szBackupOpenFunc = "CertSrvBackupOpenFileW";
LARGE_INTEGER liFileSize;
HRESULT       hr=0;

// Get the address for the desired function.    
// hInst was set by calling LoadLibrary for Certadm.dll.
pfnOpenFile = (FNCERTSRVBACKUPOPENFILEW*)GetProcAddress(hInst,
                                         szBackupOpenFunc);
if ( NULL == pfnOpenFile )
{
    printf("Failed GetProcAddress - %s, error=%d\n",
            szBackupOpenFunc,
            GetLastError() );
    exit(1); // or other appropriate error action
}

// Open the file.
// hCSBC was set by an earlier call to CertSrvBackupPrepare.
// pwszFile specifies the name of a file.
// This name could have resulted from parsing the
// output from CertSrvBackupGetDatabaseNames, and so on.
hr = pfnOpenFile(hCSBC,
                pwszFile,
                0,
                &liFileSize);
if (FAILED(hr))
{
    printf("Failed pfnOpenFile call [%x] %ws\n",
           hr,
           pwszFile);
           exit(1); // Or other appropriate error action.
}

// Use the opened file as needed.
// When you have finished using the file, call CertSrvBackupClose.
// ...

Requisiti

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

Vedi anche

CertSrvBackupClose

CertSrvBackupRead

Uso delle funzioni di backup e ripristino dei servizi certificati

Condividi tramite