ICEnroll::CAStoreFlags [C++]

CEnroll.CAStoreFlags [Visual Basic]

The CAStoreFlags property value is passed directly to CertOpenStore when the certification authority (CA) store is opened. This value is passed as CertOpenStore's dwFlags parameter. For details, see CertOpenStore in the CryptoAPI documentation. The default value for CAStoreFlags is CERT_SYSTEM_STORE_CURRENT_USER.

[Visual Basic]
objEnroll.CAStoreFlags [ = Flags ]
[C++]
HRESULT put_CAStoreFlags(DWORD Flags);
HRESULT get_CAStoreFlags(DWORD * pFlags);

Parameters

[Visual Basic] objEnroll

Object expression that resolves to a CEnroll object.

[Visual Basic,C++] Flags

Value assigned to the CAStoreFlags property. The datatype is a DWORD in C++, and a Long in Visual Basic. It is one of the following values:

• CERT_SYSTEM_STORE_CURRENT_USER
• CERT_SYSTEM_STORE_LOCAL_MACHINE
• CERT_SYSTEM_STORE_SERVICES
• CERT_SYSTEM_STORE_CURRENT_USER_GROUP_POLICY
• CERT_SYSTEM_STORE_LOCAL_MACHINE_GROUP_POLICY

[C++] pFlags

Pointer to retrieved property value.

Remarks

CAStoreFlags affects the behavior of the following methods:

• acceptPKCS7
• acceptFilePKCS7

Example Code [C++]

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");

Example Code [Visual Basic]

Const CERT_SYSTEM_STORE_LOCAL_MACHINE As Long = &H20000

' declare Certificate Enrollment Control object
Dim objXen As Object

Dim flags As Long
    
' instantiate the object
Set objXen = CreateObject("CEnroll.CEnroll.1")

' retrieve and display the CAStoreFlags value
flags = objXen.CAStoreFlags
MsgBox flags, vbOKOnly, "CAStoreFlags"

' set the CAStoreFlags value
objXen.CAStoreFlags = CERT_SYSTEM_STORE_LOCAL_MACHINE

Requirements

  Windows NT/2000: Requires Windows 2000 (or Windows NT 4.0 with the Windows NT 4.0 Option Pack).
  Header: Declared in Xenroll.h.
  Library: Use Uuid.lib.