Función CertSrvBackupPrepareW (certbcli.h)

La función CertSrvBackupPrepare se usa para preparar un servidor de Servicios de certificados para las operaciones de copia de seguridad.

Sintaxis

HRESULT CERTBCLI_API CertSrvBackupPrepareW(
  [in]  WCHAR const *pwszServerName,
  [in]  ULONG       grbitJet,
  [in]  ULONG       dwBackupFlags,
  [out] HCSBC       *phbc
);

Parámetros

[in] pwszServerName

Puntero al nombre del equipo del servidor para prepararse para la copia de seguridad en línea. Este nombre puede ser el nombre NetBIOS o el nombre DNS.

[in] grbitJet

Valor utilizado por el motor de base de datos; este valor debe establecerse en cero.

[in] dwBackupFlags

Especifica el tipo de copia de seguridad. Puede ser uno de los valores siguientes.

Valor	Significado
CSBACKUP_TYPE_FULL	Realice una copia de seguridad de la base de datos de Servicios de certificados, los registros y los archivos relacionados.
CSBACKUP_TYPE_LOGS_ONLY	Realice una copia de seguridad solo de los archivos de registro.

[out] phbc

Puntero a un identificador de contexto de copia de seguridad de Servicios de certificados (HCSBC).

Valor devuelto

El valor devuelto es hrESULT. Un valor de S_OK indica que se ha realizado correctamente y *phbc se establecerá en un HCSBC que otras API de copia de seguridad de Servicios de certificados pueden usar.

Comentarios

Antes de que se pueda realizar una copia de seguridad de Servicios de certificados, es necesario crear un HCSBC mediante CertSrvBackupPrepare. El HCSBC resultante es un parámetro necesario de las funciones de copia de seguridad de Servicios de certificados que se pueden usar para enumerar, abrir, leer y cerrar archivos, así como truncar los archivos de registro.

Nota Una vez completada la sesión de copia de seguridad, es necesario llamar a CertSrvBackupEnd para liberar el HCSBC que resultó de la llamada a CertSrvBackupPrepare.

 

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

Para ejecutar esta llamada, debe tener el privilegio de copia de seguridad. Para obtener más información, consulte Establecimiento de los privilegios de copia de seguridad y restauración.

Ejemplos

WCHAR *    wszServer = L"MyCertServerMachine";
FNCERTSRVBACKUPPREPAREW* pfnBackupPrepare;
char * szBackPrepFunc = "CertSrvBackupPrepareW";
HINSTANCE  hInst=0;
HCSBC      hCSBC=NULL;
HRESULT    hr=0;

// Load the DLL.
hInst = LoadLibrary(L"Certadm.dll");
if ( NULL == hInst )
{
    printf("Failed LoadLibrary, error=%d\n",
            GetLastError() );
    exit(1); // Or other appropriate error action.
}
// Get the address for the desired function.
pfnBackupPrepare = (FNCERTSRVBACKUPPREPAREW*)GetProcAddress( hInst,
                                        szBackPrepFunc );
if ( NULL == pfnBackupPrepare )
{
    printf("Failed GetProcAddress - %s, error=%d\n",
           szBackPrepFunc,
           GetLastError() );
    exit(1); // Or other appropriate error action.
}

// Prepare CertServ for backup.
hr = pfnBackupPrepare(wszServer,
                      0,
                      CSBACKUP_TYPE_FULL,
                      &hCSBC);
if (FAILED(hr))
{
    printf("Failed pfnBackupPrepare call [%x]\n", hr);
    exit(1); // Or other appropriate error action.
}

// Use the HCSBC for backup operations.
// ...

// When done processing, release the HCSBC context
// by calling CertSrvBackupEnd (not shown here).
// ...


// Done processing, free the DLL.
if (hInst)
    FreeLibrary(hInst);

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

CertSrvBackupEnd

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