Função CertRegisterPhysicalStore (wincrypt.h)

Artigo
08/27/2023

A função CertRegisterPhysicalStore adiciona um repositório físico a uma coleção de repositórios do sistema de registro.

Sintaxe

BOOL CertRegisterPhysicalStore(
  [in] const void                *pvSystemStore,
  [in] DWORD                     dwFlags,
  [in] LPCWSTR                   pwszStoreName,
  [in] PCERT_PHYSICAL_STORE_INFO pStoreInfo,
  [in] void                      *pvReserved
);

Parâmetros

[in] pvSystemStore

A coleção do repositório do sistema à qual o repositório físico é adicionado. Esse parâmetro aponta para uma cadeia de caracteres Unicode terminada em nulo ou para uma estrutura de CERT_SYSTEM_STORE_RELOCATE_PARA . Para obter informações sobre como usar a estrutura e sobre como adicionar um ServiceName ou ComputerName antes da cadeia de caracteres de nome do repositório do sistema, consulte CertRegisterSystemStore.

[in] dwFlags

A palavra alta do parâmetro dwFlags especifica o local do repositório do sistema. Para obter informações sobre sinalizadores de palavra alta definidos e a anexação de ServiceName, UserNames e ComputerNames ao final do nome do repositório do sistema, consulte CertRegisterSystemStore.

Os sinalizadores de palavra baixa a seguir também são definidos e podem ser combinados com sinalizadores de palavra alta usando uma operação OR bit a bit.

Valor	Significado
CERT_SYSTEM_STORE_RELOCATE_FLAG	O repositório do sistema não está em seu local de registro padrão e o parâmetro pvSystemStore deve ser um ponteiro para uma estrutura CERT_SYSTEM_STORE_RELOCATE_PARA .
CERT_STORE_CREATE_NEW_FLAG	A função falhará se o repositório físico já existir no local do repositório.

[in] pwszStoreName

Um ponteiro para uma cadeia de caracteres Unicode que nomeia o repositório físico a ser adicionado à coleção do repositório do sistema. Para remover um repositório físico da coleção de repositórios do sistema, chame a função CertUnregisterPhysicalStore .

[in] pStoreInfo

Um ponteiro para uma estrutura CERT_PHYSICAL_STORE_INFO que fornece informações básicas sobre o repositório físico.

[in] pvReserved

Reservado para uso futuro e deve ser definido como NULL.

Valor retornado

Se a função for bem-sucedida, a função retornará diferente de zero.

Se a função falhar, ela retornará zero.

Requisitos


Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wincrypt.h
Biblioteca	Crypt32.lib
DLL	Crypt32.dll