CertSetStoreProperty

This function sets a store property.

BOOL CertSetStoreProperty(
HCERTSTORE hCertStore,
DWORD dwPropId,
DWORD dwFlags,
const void *pvData
);

Parameters

• hCertStore
  [in] Handle for the certificate store.

• dwPropId
  [in] Indicates one of a range of store properties. Values for user-defined properties must be outside the current range of predefined context property values. Currently, user-defined pwPropId values begin at 4,096. There is one predefined store property, CERT_STORE_LOCALIZED_NAME_PROP_ID, which is the localized name of the store.

• dwFlags
  [in] Reserved for future use and must be zero.

• pvData
  [in] The type definition for the pvData parameter depends on the dwPropId value. If dwPropId is CERT_STORE_LOCALIZED_NAME_PROP_ID, then pvData points to a CRYPT_DATA_BLOB structure. The pbData member of that structure is a pointer to a NULL-terminated Unicode character string. The cbData member of that structure is a DWORD value holding the length of the string.

  For user-defined dwPropId values, the pvData parameter is a pointer to an encoded PCRYPT_DATA_BLOB.

  If a value already exists for the selected property, the old value is replaced.

  Calling this function with the pvData parameter set to NULL deletes a property.

Return Values

If the function succeeds, the return value is TRUE.

If the function fails, the return value is FALSE.

Remarks

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

Requirements

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

CertGetStoreProperty, CRYPT_DATA_BLOB, PCRYPT_DATA_BLOB

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.