ICEnroll::get_RequestStoreFlags method (xenroll.h)

Article
02/22/2024

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

The RequestStoreFlags property sets or retrieves the registry location used for the request 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_RequestStoreFlags(
  LONG *pdwFlags
);

Parameters

pdwFlags

Return value

None

Remarks

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

Typically, modification of the RequestStoreFlags property is performed only in advanced applications.

The RequestStoreFlags 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_RequestStoreFlags( &dwFlags );
if ( FAILED ( hr ) )
    printf("Failed retrieving RequestStoreFlags - %x\n", hr );
else
    printf("RequestStoreFlags is %x\n", dwFlags );

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