Platform SDK: Certificate Enrollment Control

ICEnroll::CAStoreType [C++]

CEnroll.CAStoreType [Visual Basic]

The CAStoreType property specifies the type of store to use for the store specified by the CAStoreName property. CAStoreType's value is passed directly on to CertOpenStore. By default, this value is sz_CERT_STORE_PROV_SYSTEM.

Currently only system stores are supported.

[Visual Basic]
objEnroll.CAStoreType [ = Type ]
[C++]
HRESULT put_CAStoreType(BSTR Type);
HRESULT get_CAStoreType(BSTR * pType);

Parameters

[Visual Basic] objEnroll
Object expression that resolves to a CEnroll object.
[Visual Basic,C++] Type
The string value assigned to the CAStoreType property. It is one of the following currently supported store provider types:
Store provider type Value
sz_CERT_STORE_PROV_SYSTEM_W "System"
sz_CERT_STORE_PROV_SYSTEM "System"

[C++] pType
Pointer to retrieved property value.

Remarks

CAStoreType affects the behavior of the following methods:

Example Code [C++]

BSTR     bstrStoreType = NULL;
HRESULT  hr;

// pEnroll is previously instantiated ICEnroll interface pointer

// get the storetype
hr = pEnroll->get_CAStoreType( &bstrStoreType );
if ( FAILED ( hr ) )
    printf("Failed getting CAStoreType - %x\n", hr );
else
    printf( "CAStoreType: %ws\n", bstrStoreType );
// free BSTR when done
if ( NULL != bstrStoreType )
    SysFreeString( bstrStoreType );

// set the storetype
// bstrNewType previously set to a valid store type
hr = pEnroll->put_CAStoreType( bstrNewType );
if ( FAILED ( hr ) )
    printf("Failed setting CAStoreType - %x\n", hr );
else
    printf( "CAStoreType was set to %ws\n", bstrNewType ); 

Example Code [Visual Basic]

' declare Certificate Enrollment Control object
Dim objXen As Object

Dim strStoreType As String

' instantiate the object
Set objXen = CreateObject("CEnroll.CEnroll.1")

' retrieve and display the CAStoreType
strStoreType = objXen.CAStoreType
MsgBox strStoreType, vbOKOnly, "CAStoreType"

' set the CAStoreType
' (strNewType previously set to a valid store type)
objXen.CAStoreType = strNewType 

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.