CERT_SYSTEM_STORE_RELOCATE_PARA structure (wincrypt.h)

The CERT_SYSTEM_STORE_RELOCATE_PARA structure contains data to be passed to CertOpenStore when that function's dwFlags parameter is set to CERT_SYSTEM_STORE_RELOCATE_FLAG. It allows the application to specify not only the name of the store to be opened, but also registry hKey information indicating a registry location other than the default location.

Syntax

typedef struct _CERT_SYSTEM_STORE_RELOCATE_PARA {
  union {
    HKEY hKeyBase;
    void *pvBase;
  } DUMMYUNIONNAME;
  union {
    void    *pvSystemStore;
    LPCSTR  pszSystemStore;
    LPCWSTR pwszSystemStore;
  } DUMMYUNIONNAME2;
} CERT_SYSTEM_STORE_RELOCATE_PARA, *PCERT_SYSTEM_STORE_RELOCATE_PARA;

Members

DUMMYUNIONNAME

DUMMYUNIONNAME.hKeyBase

A handle to registry hKey.

DUMMYUNIONNAME.pvBase

A pointer to a void to allow the system store location's base to be passed in a number of different forms.

DUMMYUNIONNAME2

DUMMYUNIONNAME2.pvSystemStore

A pointer to a void to allow the name of the system store to be passed in various forms.

DUMMYUNIONNAME2.pszSystemStore

A null-terminated ASCII string that names the system store.

DUMMYUNIONNAME2.pwszSystemStore

A null-terminated Unicode string that names the system store.

Remarks

The relocate capability is used to access system stores persisted in the Group Policy Template (GPT). For example, the Group Policy Editor's MMC snap-in extension for managing group policy trust lists and certificates uses the GPT's base HKEY to call CertOpenStore.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Header wincrypt.h

See also

CertOpenStore