Windows CE 3.0

This function retrieves a store property.

BOOL CertGetStoreProperty(
DWORD dwPropId,
void *pvData,
DWORD *pcbData


[in] Handle of an open certificate store.
[in] Indicates one of a range of store properties. There is one predefined store property, CERT_STORE_LOCALIZED_NAME_PROP_ID, which is the localized name of the store.

User-defined properties must be outside the current range of values for predefined context properties. Currently, user-defined dwPropId values begin at 4,096.

[out] Pointer to a buffer that receives the data as determined by the dwPropId parameter. For CERT_STORE_LOCALIZED_NAME_PROP_ID, this is the localized name of the store, and the pvData parameter points to a NULL-terminated Unicode, wide-character string. For other dwPropId parameters, the pvData points to an array of bytes.

This parameter can be NULL to set the size of this information for memory allocation purposes.

[in/out] Pointer to a DWORD value that specifies the size, in bytes, of the pvData buffer. When the function returns, the DWORD value contains the number of bytes stored in the buffer.

Return Values

If the function succeeds, the return value is TRUE.

If the function fails, the return value is FALSE.

If the store property is found, the function returns TRUE, pvData points to the property, and pcbData points to the length of the string. If the store property is not found, the function returns FALSE and the GetLastError function returns CRYPT_E_NOT_FOUND.


Store property identifiers are properties applicable to an entire store. They are not properties on an individual certificate context. Currently, no store properties are persisted.


Runs on Versions Defined in Include Link to
Windows CE OS 3.0 or later Wincrypt.h   Crypt32.lib
Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also


 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.