IPredictorClient::get_fpDefaultConfidence, put_fpDefaultConfidence
.gif "Ee825955.c++_off(en-US,CS.10).gif")
.gif "Ee825955.vb_on(en-US,CS.10).gif")
The read/write fpDefaultConfidence property determines the threshold below which predictions are not returned by the PredictorClient object.
Definition
Get method:
HRESULT IPredictorClient::get_fpDefaultConfidence(float*pVal);
Put method:
HRESULT IPredictorClient::put_fpDefaultConfidence(floatpVal);
Parameters
pVal
[in] When putting the property, a float that contains the threshold confidence for prediction. Valid range is 0 to 100.
[out, retval] When getting the property, a pointer to a float used to return the cutoff value for prediction confidence.
Return Values
These methods return an HRESULT indicating whether or not it completed successfully. See the following Error Values section for more details.
Error Values
These methods return S_OK (0x00000000) to indicate success and standard COM HRESULT error values to indicate failure. For more information about standard COM errors, see Standard COM Errors. Additional information may be available using the global Err object, which can be accessed using the API function GetErrorInfo. In particular, the GetDescription method of the IErrorInfo interface may return a text description of the error.
The following standard COM error value has a particular meaning in the context of this property.
E_INVALIDARG
The value of the property is outside the valid range of 0 to 100.
Remarks
The fpDefaultConfidence property is a threshold that determines which attributes can be shown on the recommendation list. When a prediction is made, each attribute is assigned a probability of "not missing", which in most uses will correspond to the probability that the product will be purchased. If this probability (in percentage) falls below fpDefaultConfidence, then the attribute is not shown on the recommendation list even when this probability is large relative to probabilities of the other attributes being "not missing". The property should be within the range of 0 to 100, but a value of zero (0) is recommended unless the fpPopularityPenalty property is set to zero (0).
Set a default value for this property in the global.asa file to avoid setting the value for each Predict method call.
For more information about memory ownership issues related to COM property and method parameters, see Managing COM Parameter Memory.
The pVal parameter contains valid data only if the property is accessed successfully.