ICEnroll::get_RootStoreFlags method (xenroll.h)

Article
02/22/2024

[This property is no longer available for use as of Windows Server 2008 and Windows Vista.]

The RootStoreFlags property sets or retrieves the registry location used for the root store.

The default value for this property is CERT_SYSTEM_STORE_CURRENT_USER. This property was first defined in the ICEnroll interface.

This property is read/write.

Syntax

HRESULT get_RootStoreFlags(
  LONG *pdwFlags
);

Parameters

pdwFlags

Return value

None

Remarks

The RootStoreFlags property value is passed to the CertOpenStore CryptoAPI function by using its dwFlags parameter.

The RootStoreFlags property should be set before using the following methods:

Examples

DWORD    dwFlags;
HRESULT  hr;

// pEnroll is previously instantiated ICEnroll interface pointer.

// Retrieve the flag value.
hr = pEnroll->get_RootStoreFlags( &dwFlags );
if ( FAILED ( hr ) )
    printf("Failed retrieving RootStoreFlags - %x\n", hr );
else
    printf("RootStoreFlags is %x\n", dwFlags );

// Set the flag.
hr = pEnroll->put_RootStoreFlags( CERT_SYSTEM_STORE_LOCAL_MACHINE );
if ( FAILED ( hr ) )
    printf("Failed updating RootStoreFlags - %x\n", hr );
else
    printf("Updated RootStoreFlags\n");

Requirements

Requirement	Value
Minimum supported client	Windows XP [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	xenroll.h
Library	Uuid.lib
DLL	Xenroll.dll

Share via