Export (0) Print
Expand All

ICEnroll4::CAStoreName property

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

The CAStoreName property sets or retrieves the name of the store where all non-"ROOT" and non-"MY" certificates are kept.

The default value for this property is "CA". This property was first defined in the ICEnroll interface.

This property is read/write.

Syntax


HRESULT put_CAStoreName(
  [in]   BSTR Name
);

HRESULT get_CAStoreName(
  [out]  BSTR *pName
);

Property value

A string that represents the name of the CA store. The string can be any defined store name. The following list shows some possible values. The default value is "CA".

  • "CA"
  • "MY"
  • "ROOT"

Error codes

If the property access methods put_CAStoreName and get_CAStoreName succeed, they return S_OK.

Any other HRESULT value indicates that the call failed.

Remarks

The CAStoreName property affects the behavior of the following methods:

The ability to set this property is disabled when the Certificate Enrollment Control is executed as a scripted control.

Examples


BSTR     bstrStoreName = NULL;
HRESULT  hr;

// pEnroll is previously instantiated ICEnroll interface pointer

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

// set the storename
// bstrNewName previously set to a valid store name
hr = pEnroll->put_CAStoreName( bstrNewName );
if ( FAILED ( hr ) )
    printf("Failed setting CAStoreName - %x\n", hr );
else
    printf( "CAStoreName was set to : %ws\n", bstrNewName );

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

End of client support

Windows XP

End of server support

Windows Server 2003

Header

Xenroll.h

Library

Uuid.lib

DLL

Xenroll.dll

IID

IID_ICEnroll4 is defined as c1f1188a-2eb5-4a80-841b-7e729a356d90

 

 

Community Additions

ADD
Show:
© 2014 Microsoft