ICreditCardEncryption2::PreDelete

Syntax

STDMETHOD PreDelete(
HWND hWnd// in
CREDITCARDINFO *pOldCCInfo// in
BYTE ** ppBlob// out
long *cLen// in, out
BSTR *pbstrErrMsg// out
);

Description

The PreDelete method is called when a payment instance is to be deleted. The Wallet calls this method to give the Payment Builder a chance to warn the user in the event that the deletion will affect the user of the protocol. The Payment Builder provides this warning by returning S_FALSE, and by storing the text of the warning in the pbstrErrMsg out parameter.

If the shopper opts not to continue the deletion, the Delete method is not called.

Parameters

hWnd

Window handle to the parent window.

pOldCCInfo

Pointer to the original credit-card information.

ppBlob

Address where this function returns a pointer to a blob that will be stored by the Credit Card component and given to the protocol when a payment instruction is generated. The ppBlob value should be Null if the protocol does not need any information to be stored. **ppBlob is the blob originally stored when the card was added or last modified. If the blob is changed, the protocol must free the original blob and dynamically allocate a new blob. This memory will be freed by the Credit Card CPC.

cLen

Length of the blob.

pbstrErrMsg

The address to which the method returns a status message that the Wallet displays to the user.

Return Value

The CPC displays the message contained in bstrErrMsg to the user only if PreDelete returns S_FALSE.