IEnroll4::DeleteRequestCert property

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

The DeleteRequestCert property sets or retrieves a Boolean value that determines whether dummy certificates in the request store are deleted.

Dummy certificates are created for the purpose of persisting the keys generated for the PKCS #10 request during the enrollment process. The store specified by the RequestStoreNameWStr property is where the dummy certificate is created. The newly generated keys are added as properties to the dummy certificate to persist them until a certification authority processes the request and responds with a PKCS #7. On acceptance of the PKCS #7, the dummy certificate is removed and the keys are added as properties of the issued certificate returned by the certification authority. For debugging and testing, it is often desirable to not delete the dummy certificate. Setting DeleteRequestCert to false prevents its deletion.

The default value for this property is true. This property was first defined in the IEnroll interface.

This property is read/write.

Syntax


HRESULT put_DeleteRequestCert(
  [in]  BOOL fDelete
);

HRESULT get_DeleteRequestCert(
  [out] BOOL *pfDelete
);

Property value

BOOL value assigned to the DeleteRequestCert property. The default value is true.

Error codes

If the property access methods put_DeleteRequestCert and get_DeleteRequestCert succeed, they return S_OK.

Any other HRESULT value indicates that the call failed.

Remarks

The DeleteRequestCert 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

 

 

Show: