Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
RequestStoreNameWStr Property

IEnroll4::RequestStoreNameWStr property

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

The RequestStoreNameWStr property sets or retrieves the name of the store that contains the dummy certificate. This dummy certificate, along with the added private keys, remains in the request store until a certification authority processes the request and responds with a PKCS #7.

The default value for this property is "REQUEST". If the default is not to be used, this property must be set to the store to be used before calls to createPKCS10WStr/createFilePKCS10WStr and again before calls to acceptPKCS7Blob/acceptFilePKCS7WStr.

This property was first defined in the IEnroll interface.

This property is read/write.

Syntax


HRESULT put_RequestStoreNameWStr(
  [in]  LPWSTR szwName
);

HRESULT get_RequestStoreNameWStr(
  [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 "REQUEST".

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

Error codes

If the property access methods put_RequestStoreNameWStr and get_RequestStoreNameWStr succeed, they return S_OK.

Any other HRESULT value indicates that the call failed.

Remarks

Typically, modification of the RequestStoreNameWStr property is performed only in advanced applications. Changing this value is not recommended for most applications.

The RequestStoreNameWStr property 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

 

 

Community Additions

ADD
Show:
© 2015 Microsoft