IAppFrameWork::VerifyWith Method [C++]

  • Article

Use this method to generate hidden input fields that contain verification values.

Definition

[C++]

HRESULT IAppFrameWork::VerifyWith(IDispatch*pdispOrder,
  SAFEARRAY(VARIANT)pParams,
  BSTR*pbstrRet);

[Visual Basic]

Function VerifyWith(pdispOrder As Object
pParams As Variant) As Variant

Parameters

  • pdispOrder[C++]
    [in] A pointer to the IDispatch interface that can be used to retrieve the OrderForm object that contains the fields to verify.
  • pdispOrder[Visual Basic]
    An object reference to the OrderForm object that contains the fields to verify.
  • pParams[C++]
    [in] A SAFEARRAY that contains a list of field names to verify in the supplied OrderForm object.
  • pParams[Visual Basic]
    A variable list of arguments of type VARIANT, that contain the field names to verify in the supplied OrderForm object.
  • pvtRet[C++]
    [out, retval] A pointer to a VARIANT used to return the HTML tags.

Return Values

[C++] This method returns an HRESULT indicating whether it completed successfully. See the Error Values section for more details.

[Visual Basic] If this method completes successfully, it returns a Variant that contains the HTML tags.

Error Values

[C++] This method returns 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.

[Visual Basic] This method sets the Number property of the global Err object to S_OK (&H00000000) to indicate success and to standard COM 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. In particular, the Description property may contain a text description of the error.

Remarks

[C++] The pvtRet parameter points to valid data only if the method completed successfully.

Use this method to output HTML tags in the form <INPUT TYPE="HIDDEN"> in an HTML form. These hidden fields contain specified values from the OrderForm object to be used to verify that an order has not been altered between presentation of the OrderForm object and final purchase.

For more information about memory ownership issues related to COM property and method parameters, see Managing COM Parameter Memory.

Example

[Visual Basic]

' oAppFrameWork is a Commerce.AppFrameWork object.
' The following example generates hidden fields containing 
' the values stored in the _total_total,and _tax_total fields
' of the supplied OrderForm object:
<FORM METHOD="POST"
    ACTION="https://example.microsoft.com/xt_orderform_purchase.asp">
    <% = oAppFrameWork.VerifyWith(mscsOrderForm, "_total_total", _
 "_tax_total") %>
' When the page containing this call is loaded in the client 
' browser, the document source for the page would contain the
' following HTML script (assuming a total of 138.95 and a tax
' of 8.75):
<FORM METHOD="POST"
ACTION="https://example.microsoft.com/xt_orderform_purchase.asp">
<INPUT TYPE=HIDDEN NAME="_VERIFY_WITH" VALUE="_total_total=13895">
<INPUT TYPE=HIDDEN NAME="_VERIFY_WITH" VALUE="_tax_total=875">

See Also

[C++]AppFrameWork Object

[C++]OrderForm Object

[Visual Basic]AppFrameWork Object

[Visual Basic]OrderForm Object

Copyright © 2005 Microsoft Corporation.
All rights reserved.