IEnroll4::RootStoreNameWStr property

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

The RootStoreNameWStr property sets or retrieves the name of the root store where all intrinsically trusted, self-signed root certificates are kept.

The default value for this property is "ROOT". Because of the level of trust associated with the root store, the user may be prompted (by means of the user interface) to accept the certificate. Although this property need not be changed for many applications, to avoid the user interface associated with trusting root certificates, a possibility is to set RootStoreNameWStr to "CA".

This property was first defined in the IEnroll interface.

This property is read/write.

Syntax


HRESULT put_RootStoreNameWStr(
  [in]  LPWSTR szwName
);

HRESULT get_RootStoreNameWStr(
  [out] LPWSTR *pszwName
);

Property value

A pointer to a null-terminated wide character string that contains the store name. The string can be any defined store name. The following list shows some possible values. The default value is "ROOT".

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

Error codes

If the property access methods put_RootStoreNameWStr and get_RootStoreNameWStr succeed, they return S_OK.

Any other HRESULT value indicates that the call failed.

Remarks

RootStoreNameWStr affects the behavior of the following methods:

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_IEnroll4 is defined as f8053fe5-78f4-448f-a0db-41d61b73446b

See also

IEnroll4

 

 

Show: