Previous in Contents Next in Contents

IWalletCallback::Exists

Syntax

HRESULT Exists(
BSTR
bstrFriendName// in
long *plExists// out
);

Description

The Exists function must be called during add (IClientPaymentProvider::NewPaymentInstance) and modify (IClientPaymentProvider::ManagePaymentInstance) operations before an instance can be created or a friendly name modified. This function ensures that the friendly name being added or modified is unique across all components in the Payment Selector. A warning flag will be returned indicating whether the friendly name already exists. If so, this instance must not be created; the user should be prompted to enter a new friendly name.

Parameters

bstrFriendName
Friendly name of the instance that must be verified as unique across all components in the Payment Selector.
plExists
Non-zero if the specified friendly name is already in use.

Return Value

This function returns one of the following values.

Value Meaning
S_OK Success
E_FAIL Failure

Remarks

Note that this interface is exposed to the CPC during the IClientPaymentProvider::Create function, which is called before all other functions. Therefore, the CPC must save the interface pointer to use during add and modify operations.

Related Topics


© 1997-2000 Microsoft Corporation. All rights reserved.