Função CertEnumSystemStoreLocation (wincrypt.h)

Artigo
03/03/2024

A função CertEnumSystemStoreLocation recupera todos os locais de repositório do sistema. A função chama a função de retorno de chamada fornecida para cada local de repositório do sistema encontrado.

Sintaxe

BOOL CertEnumSystemStoreLocation(
  [in] DWORD                               dwFlags,
  [in] void                                *pvArg,
  [in] PFN_CERT_ENUM_SYSTEM_STORE_LOCATION pfnEnum
);

Parâmetros

[in] dwFlags

Reservado para uso futuro; deve ser zero.

[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 local de repositório. Essa função de retorno de chamada determina o conteúdo e o formato para a apresentação de informações em cada local do repositório. Para obter a assinatura e os parâmetros da função de retorno de chamada, consulte CertEnumSystemStoreLocationCallback.

Retornar valor

Se a função for bem-sucedida, a função retornará TRUE.

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

Comentários

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

Exemplos

Para obter um exemplo que usa essa função, consulte Exemplo de programa C: listando o sistema e repositórios físicos.

Requisitos

Requisito	Valor
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