Initiates client certificate negotiation with a Web client.
[IN] true to specify that negotiation should occur asynchronously; otherwise, false.
[OUT] true to specify that an asynchronous completion is pending; otherwise, false.
An HRESULT. Possible values include, but are not limited to, those in the following table.
Indicates that the operation was successful.
Indicates that the operation failed.
Developers can use the NegotiateClientCertificate method to manually initiate client certificate negotiation with a Web client, even if IIS is configured to accept or ignore client certificates. NegotiateClientCertificate supports both synchronous and asynchronous operation by specifying the appropriate setting in the fAsync parameter. When your module calls NegotiateClientCertificate asynchronously, the module must return processing to the integrated request-processing pipeline immediately after calling the method if the pfCompletionPending value indicates that an asynchronous completion is pending.
The following example demonstrates how to call NegotiateClientCertificate method.