SignalUserCancel Property
SignalUserCancel
For some operations, this property is an implementation of a delegate
the KeyCollector can call to indicate the user is canceling the
operation. If it is null, report cancellation normally, by having the
KeyCollector return false
. If it is not null, use the supplied
delegate to report user cancellation.
public SignalUserCancel SignalUserCancel { get; }
Property Value
Type | Description |
---|---|
SignalUserCancel |
Remarks
Currently this is valid only when the Request
is either
TouchRequest,
EnrollFingerprint, or
VerifyFido2Uv. For all other
requests, this will be null.
The normal way to indicate that a user is canceling an operation is
to have the KeyCollector return false
. However, for some
operations, such as Touch and Fingerprint, the KeyCollector is called
on a separate thread and the return is ignored. That is, it is an
asynchronous call. The main thread performing the YubiKey operation
will not see the KeyCollector's return. Hence, to indicate user
cancellation in these cases, this delegate is provided.
Your KeyCollector is called with an instance of this
KeyEntryData
class. If this property is not null, you can save
this delegate. Later on, if the user cancels, you can call the
delegate. If the YubiKey has not completed the operation or timed out
by the time it receives notification of user cancellation, the SDK
can cancel. Note that generally, user cancellation results in an
OperationCanceledException
.