Função CertEnumPhysicalStore (wincrypt.h)

Artigo
08/27/2023

A função CertEnumPhysicalStore recupera os repositórios físicos em um computador. A função chama a função de retorno de chamada fornecida para cada repositório físico encontrado.

Sintaxe

BOOL CertEnumPhysicalStore(
  [in] const void                   *pvSystemStore,
  [in] DWORD                        dwFlags,
  [in] void                         *pvArg,
  [in] PFN_CERT_ENUM_PHYSICAL_STORE pfnEnum
);

Parâmetros

[in] pvSystemStore

Se CERT_SYSTEM_STORE_RELOCATE_FLAG for definido em dwFlags, pvSystemStore apontará para uma estrutura CERT_SYSTEM_STORE_RELOCATE_PARA que indica o nome e o local do repositório do sistema a ser enumerado. Caso contrário, pvSystemStore é um ponteiro para uma cadeia de caracteres Unicode que nomeia o repositório do sistema cujos repositórios físicos devem ser enumerados. Para obter informações sobre como prefixar um ServiceName ou ComputerName no nome do repositório do sistema, consulte CertRegisterSystemStore.

[in] dwFlags

Especifica o local do repositório do sistema. Os seguintes valores de sinalizador são definidos:

CERT_SYSTEM_STORE_CURRENT_USER
CERT_SYSTEM_STORE_CURRENT_SERVICE
CERT_SYSTEM_STORE_LOCAL_MACHINE
CERT_SYSTEM_STORE_LOCAL_MACHINE_GROUP_POLICY
CERT_SYSTEM_STORE_CURRENT_USER_GROUP_POLICY
CERT_SYSTEM_STORE_SERVICES
CERT_SYSTEM_STORE_USERS
CERT_SYSTEM_STORE_LOCAL_MACHINE_ENTERPRISE

Além disso, CERT_SYSTEM_STORE_RELOCATE_FLAG ou CERT_PHYSICAL_STORE_PREDEFINED_ENUM_FLAG podem ser combinados usando uma operação OR bit a bit com qualquer um dos sinalizadores de localização de palavras altas.

[in] pvArg

Um ponteiro para um nulo que permite que o aplicativo declare, defina e inicialize uma estrutura para manter todas as informações a serem passadas para a função de enumeração de retorno de chamada.

[in] pfnEnum

Um ponteiro para a função de retorno de chamada usada para mostrar os detalhes de cada repositório físico. Essa função de retorno de chamada determina o conteúdo e o formato para a apresentação de informações em cada repositório físico. O aplicativo deve fornecer a função de retorno de chamada CertEnumPhysicalStoreCallback .

Valor retornado

Se a função for bem-sucedida e outro repositório físico for encontrado, o valor retornado será TRUE.

Se o local do repositório do sistema só der suporte a repositórios do sistema e não der suporte a repositórios físicos, a função retornará FALSE e GetLastError retornará o código ERROR_NOT_SUPPORTED.

Se a função falhar e outro repositório físico não for encontrado, o valor retornado será FALSE. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Para usar CertEnumPhysicalStore, um aplicativo deve declarar e definir a estrutura ENUM_ARG e uma função de retorno de chamada de enumeração.

Exemplos

Consulte Exemplo de programa C: listando o sistema e repositórios físicos.

Requisitos


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