CertSetStoreProperty

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function sets a store property.

Syntax

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

Parameters

• hCertStore
  [in] Handle to the certificate store.

• dwPropId
  [in] Specifies 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 set to zero.

• pvData
  [in] Pointer to a CRYPT_DATA_BLOB structure, if the value of the dwPropId parameter is CERT_STORE_LOCALIZED_NAME_PROP_ID. The type definition for the pvData parameter depends on the dwPropId value. 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 Value

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

See Also

Reference

CertGetStoreProperty
BLOB (Cryptography)
BLOB (Cryptography)