IMimeSecurity::EnumCertificates method

  • Article

Enumerates the certificates from the specified store.

Syntax

HRESULT EnumCertificates(
  [in]  HCAPICERTSTORE hc,
  [in]  DWORD          dwUsage,
  [in]  PCX509CERT     pPrev,
  [out] PCX509CERT     *ppCert
);

Parameters

hc [in]

Type: HCAPICERTSTORE

Specifies the handle to the certificate store.

dwUsage [in]

Type: DWORD

Specifies the thumbprint type. A value of zero indicates that the caller is checking whether any certificates exist.

ITT_SIGNING (0x00000001)

ITT_ENCRYPTION (0x00000002)

pPrev [in]

Type: PCX509CERT

Specifies a pointer to the last CERT_CONTEXT structure enumerated by this method. Use NULL to indicate that the ppCert should receive the first certificate in the enumeration.

ppCert [out]

Type: PCX509CERT*

Receives a pointer to the next CERT_CONTEXT structure in the enumeration.

Return value

Type: HRESULT

Returns one of the following values.

Return code Description
S_OK
 Indicates success.
S_FALSE
 Indicates that dwUsage is zero and there are no certificates.
E_INVALIDARG
 Indicates that hc or ppCert is NULL.
CRYPT_E_NOT_FOUND
 Indicates that there are no more certificates.

Requirements
Minimum supported client
 Windows XP [desktop apps only]
Minimum supported server
 Windows Server 2003 [desktop apps only]
Product
 Outlook Express 6.0
Header
Mimeole.h
IDL
Mimeole.idl
DLL
Inetcomm.dll (version 6.0 or later)