Skip to content

Latest commit

 

History

History
119 lines (99 loc) · 6.27 KB

nf-xenroll-icenroll-get_rootstoretype.md

File metadata and controls

119 lines (99 loc) · 6.27 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:xenroll.ICEnroll.get_RootStoreType
ICEnroll::get_RootStoreType (xenroll.h)
Sets or retrieves the type of store to use for the store specified by the RootStoreName property. (Get)
CEnroll object [Security]
RootStoreType property
ICEnroll interface [Security]
RootStoreType property
ICEnroll.RootStoreType
ICEnroll.get_RootStoreType
ICEnroll2 interface [Security]
RootStoreType property
ICEnroll2.RootStoreType
ICEnroll2::get_RootStoreType
ICEnroll2::put_RootStoreType
ICEnroll3 interface [Security]
RootStoreType property
ICEnroll3.RootStoreType
ICEnroll3::get_RootStoreType
ICEnroll3::put_RootStoreType
ICEnroll4 interface [Security]
RootStoreType property
ICEnroll4.RootStoreType
ICEnroll4::RootStoreType
ICEnroll4::get_RootStoreType
ICEnroll4::put_RootStoreType
ICEnroll::get_RootStoreType
ICEnroll::put_RootStoreType
RootStoreType property [Security]
RootStoreType property [Security]
CEnroll object
RootStoreType property [Security]
ICEnroll interface
RootStoreType property [Security]
ICEnroll2 interface
RootStoreType property [Security]
ICEnroll3 interface
RootStoreType property [Security]
ICEnroll4 interface
get_RootStoreType
security.icenroll4_rootstoretype
sz_CERT_STORE_PROV_SYSTEM
sz_CERT_STORE_PROV_SYSTEM_W
xenroll/ICEnroll2::RootStoreType
xenroll/ICEnroll2::get_RootStoreType
xenroll/ICEnroll2::put_RootStoreType
xenroll/ICEnroll3::RootStoreType
xenroll/ICEnroll3::get_RootStoreType
xenroll/ICEnroll3::put_RootStoreType
xenroll/ICEnroll4::RootStoreType
xenroll/ICEnroll4::get_RootStoreType
xenroll/ICEnroll4::put_RootStoreType
xenroll/ICEnroll::RootStoreType
xenroll/ICEnroll::get_RootStoreType
xenroll/ICEnroll::put_RootStoreType
security\icenroll4_rootstoretype.htm
security
452f89ad-e512-4ac7-816a-c3f97e25350a
12/05/2018
CEnroll object [Security],RootStoreType property, ICEnroll interface [Security],RootStoreType property, ICEnroll.RootStoreType, ICEnroll.get_RootStoreType, ICEnroll2 interface [Security],RootStoreType property, ICEnroll2.RootStoreType, ICEnroll2::get_RootStoreType, ICEnroll2::put_RootStoreType, ICEnroll3 interface [Security],RootStoreType property, ICEnroll3.RootStoreType, ICEnroll3::get_RootStoreType, ICEnroll3::put_RootStoreType, ICEnroll4 interface [Security],RootStoreType property, ICEnroll4.RootStoreType, ICEnroll4::RootStoreType, ICEnroll4::get_RootStoreType, ICEnroll4::put_RootStoreType, ICEnroll::get_RootStoreType, ICEnroll::put_RootStoreType, RootStoreType property [Security], RootStoreType property [Security],CEnroll object, RootStoreType property [Security],ICEnroll interface, RootStoreType property [Security],ICEnroll2 interface, RootStoreType property [Security],ICEnroll3 interface, RootStoreType property [Security],ICEnroll4 interface, get_RootStoreType, security.icenroll4_rootstoretype, sz_CERT_STORE_PROV_SYSTEM, sz_CERT_STORE_PROV_SYSTEM_W, xenroll/ICEnroll2::RootStoreType, xenroll/ICEnroll2::get_RootStoreType, xenroll/ICEnroll2::put_RootStoreType, xenroll/ICEnroll3::RootStoreType, xenroll/ICEnroll3::get_RootStoreType, xenroll/ICEnroll3::put_RootStoreType, xenroll/ICEnroll4::RootStoreType, xenroll/ICEnroll4::get_RootStoreType, xenroll/ICEnroll4::put_RootStoreType, xenroll/ICEnroll::RootStoreType, xenroll/ICEnroll::get_RootStoreType, xenroll/ICEnroll::put_RootStoreType
xenroll.h
Windows
Windows XP [desktop apps only]
Windows Server 2003 [desktop apps only]
Uuid.lib
Xenroll.dll
Windows
19H1
ICEnroll::get_RootStoreType
xenroll/ICEnroll::get_RootStoreType
c++
APIRef
kbSyntax
COM
Xenroll.dll
ICEnroll4.RootStoreType
ICEnroll4.get_RootStoreType
ICEnroll4.put_RootStoreType
ICEnroll3.RootStoreType
ICEnroll3.get_RootStoreType
ICEnroll3.put_RootStoreType
ICEnroll2.RootStoreType
ICEnroll2.get_RootStoreType
ICEnroll2.put_RootStoreType
ICEnroll.RootStoreType
ICEnroll.get_RootStoreType
ICEnroll.put_RootStoreType
CEnroll.RootStoreType

ICEnroll::get_RootStoreType

-description

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

The RootStoreType property sets or retrieves the type of store to use for the store specified by the RootStoreName property. This store type is passed directly on to the CertOpenStore function.

The default value for this property is sz_CERT_STORE_PROV_SYSTEM. Only system stores are supported. This property was first defined in the ICEnroll interface.

This property is read/write.

-parameters

-remarks

RootStoreType 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     bstrStoreType = NULL;
HRESULT  hr;

// pEnroll is previously instantiated ICEnroll interface pointer

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

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