função de retorno de chamada PFN_CERT_ENUM_PHYSICAL_STORE (wincrypt.h)

Artigo
08/27/2023

A função de retorno de chamada CertEnumPhysicalStoreCallback formata e apresenta informações sobre cada repositório físico encontrado por uma chamada para CertEnumPhysicalStore.

Sintaxe

PFN_CERT_ENUM_PHYSICAL_STORE PfnCertEnumPhysicalStore;

BOOL PfnCertEnumPhysicalStore(
  [in] const void *pvSystemStore,
  [in] DWORD dwFlags,
  [in] LPCWSTR pwszStoreName,
  [in] PCERT_PHYSICAL_STORE_INFO pStoreInfo,
  [in] void *pvReserved,
  [in] void *pvArg
)
{...}

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 o nome de um serviço ou computador 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 palavra alta. A constante CERT_PHYSICAL_STORE_PREDEFINED_ENUM_FLAG será definida se o repositório físico for predefinido em vez de registrado.

[in] pwszStoreName

Nome do repositório físico.

[in] pStoreInfo

Um ponteiro para uma estrutura CERT_PHYSICAL_STORE_INFO que contém informações sobre o repositório.

[in] pvReserved

Reservado para uso futuro.

[in] pvArg

Um ponteiro para informações passadas para a função de retorno de chamada no pvArg passado para CertEnumPhysicalStore.

Valor retornado

Retornará TRUE se a função for bem-sucedida, FALSE se falhar.

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