Edit

ICEnroll::put_RootStoreFlags method (xenroll.h)

  • Article

[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 put_RootStoreFlags(
  LONG dwFlags
);

Parameters

dwFlags

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