ICEnroll::put_CAStoreFlags method (xenroll.h)

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

The CAStoreFlags property sets or retrieves a flag that controls the certification authority (CA) store when the store is opened. This flag is passed to the dwFlags parameter of the CertOpenStore function when the CA store is opened.

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

Parameters

dwFlags

Return value

None

Remarks

The CAStoreFlags property affects the behavior of the following methods:

Examples

DWORD    dwFlags;
HRESULT  hr;

// pEnroll is previously instantiated ICEnroll interface pointer

// retrieve the flag value
hr = pEnroll->get_CAStoreFlags( &dwFlags );
if ( FAILED ( hr ) )
    printf("Failed retrieving CAStoreFlags - %x\n", hr );
else
    printf("CAStoreFlags is %x\n", dwFlags );

// set the flag
hr = pEnroll->put_CAStoreFlags( CERT_SYSTEM_STORE_LOCAL_MACHINE );
if ( FAILED ( hr ) )
    printf("Failed updating CAStoreFlags - %x\n", hr );
else
    printf("Updated CAStoreFlags\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