IClientPaymentProvider::NewPaymentInstance

IClientPaymentProvider::NewPaymentInstance

Syntax

HRESULT NewPaymentInstance(
BSTRbstrType// in
long FAR *pcIdx// out
);

Description

The NewPaymentInstance function adds a new instance to the CPC. When this function is called, the Payment Selector provides the appropriate type of the instance and the CPC returns the index position of the new instance.

Parameters

bstrType: String identifying the payment type of the new instance.
pcIdx: Pointer to the location where this function will return the index to the newly created payment instance.

Return Value

This function returns one of the following values.

Value	Meaning
E_INVALIDARG	One or more of the arguments is invalid.
E_OUTOFMEMORY	Out of memory.
E_FAIL	Failure.
S_FALSE	Cancel by user.
S_OK	Success.

Remarks

During add and modify operations, the IWalletCallback::Exists function must be called to verify that no instance with the same friendly name exists across payment modules.