Windows Dev Center

ICEnroll4::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 RequestStoreName 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 the DeleteRequestCert property to FALSE prevents its deletion.

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

This property is read/write.

Syntax


HRESULT put_DeleteRequestCert(
  [in]  BOOL bValue
);

HRESULT get_DeleteRequestCert(
  [out] BOOL *pbValue
);

Property value

If TRUE, dummy certificates in the request store are deleted.

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:

Examples


BOOL     bDRC;
HRESULT  hr;


// pEnroll is a previously instantiated ICEnroll interface pointer.
// Get the DeleteRequestCert Boolean value.

hr = pEnroll->get_DeleteRequestCert( &bDRC );
if ( FAILED ( hr ) )
    printf("Failed getting DeleteRequestCert - %x\n", hr );
else
    printf( "DeleteRequestCert: %s\n", ( bDRC ? "TRUE" : "FALSE" ) );


// Set the DeleteRequestCert value.

hr = pEnroll->put_DeleteRequestCert( FALSE );
if ( FAILED ( hr ) )
    printf("Failed Setting DeleteRequestCert - %x\n", hr );
else
    printf( "DeleteRequestCert was set to FALSE\n" );

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:
© 2015 Microsoft