Função CertSrvRestoreRegisterThroughFile (certbcli.h)

A função CertSrvRestoreRegisterThroughFile registra uma restauração dos Serviços de Certificados.

Sintaxe

HRESULT CERTBCLI_API CertSrvRestoreRegisterThroughFile(
  [in]           HCSBC            hbc,
  [in, optional] WCHAR const      *pwszCheckPointFilePath,
  [in, optional] WCHAR const      *pwszLogPath,
  [in, optional] CSEDB_RSTMAPW [] rgrstmap,
  [in]           LONG             crstmap,
  [in, optional] WCHAR const      *pwszBackupLogPath,
  [in]           ULONG            genLow,
  [in]           ULONG            genHigh
);

Parâmetros

[in] hbc

Um identificador para o contexto de restauração dos Serviços de Certificados. Esse identificador é obtido chamando a função CertSrvRestorePrepare .

[in, optional] pwszCheckPointFilePath

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o caminho de restauração do arquivo de ponto marcar. Passe NULL para esse parâmetro se ele não for necessário.

[in, optional] pwszLogPath

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o diretório do arquivo de log atual. Passe NULL para esse parâmetro se ele não for necessário.

[in, optional] rgrstmap

Uma matriz de estruturas de CSEDB_RSTMAP que contém o mapa de restauração. Se você estiver executando uma restauração completa do banco de dados, esse parâmetro especificará o nome do banco de dados de backup, bem como um novo nome para o banco de dados depois que ele for restaurado. O nome do banco de dados de backup é referenciado pelo membro pwszDatabaseName e o novo nome do banco de dados é referenciado pelo membro pwszNewDatabaseName . Se a intenção for manter o mesmo nome para o banco de dados de backup e o banco de dados restaurado, defina os membros pwszNewDatabaseName e pwszDatabaseName com o mesmo nome. O nome do banco de dados de backup é construído a partir do caminho retornado pela chamada do cliente de backup para a função CertSrvRestoreGetDatabaseLocations . CertSrvRestoreGetDatabaseLocations teria sido chamado durante um backup completo e o cliente de backup teria salvo o caminho retornado.

Se você estiver executando uma restauração incremental, defina esse parâmetro como NULL.

[in] crstmap

O número de elementos na matriz rgrstmap . Defina esse valor como um se você estiver executando uma restauração completa ou zero se estiver executando uma restauração incremental.

[in, optional] pwszBackupLogPath

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o caminho para o diretório de log de backup. Passe NULL para esse parâmetro se ele não for necessário.

[in] genLow

O número de log mais baixo que foi restaurado nesta sessão de restauração. Os arquivos de log estão na forma de edbXXXXX.log, em que XXXXX é um valor de cinco dígitos hexadecimal. Por exemplo, edb00001.log é o primeiro arquivo de log criado pelo banco de dados interno. Para fins dessa função, um valor de um em genLow corresponde ao arquivo de log edb00001.log.

[in] genHigh

O número de log mais alto que foi restaurado nesta sessão de restauração.

Retornar valor

O valor retornado é um HRESULT. Um valor de S_OK indica êxito.

Comentários

Essa função é idêntica à função CertSrvRestoreRegister , exceto que CertSrvRestoreRegister exige que a conta de chamada seja um administrador local. A função CertSrvRestoreRegisterThroughFile requer apenas que a conta de chamada tenha o privilégio de restauração.

Requisitos

Confira também

CertSrvRestoreRegister

CertSrvRestoreRegisterComplete

Usando as funções de Backup e Restauração dos Serviços de Certificados