ISCardVerify::ChangeCode

The ChangeCode method replaces the current CHV (card holder verification) code with new CHV code.

HRESULT ChangeCode(
  LPBYTEBUFFER pOldCode,
  LPBYTEBUFFER pNewCode,
  SCARD_FLAGS Flags,
  LONG lRef
);

Parameters

pOldCode [in]
An IByteBuffer containing the user's current code.
pNewCode [in]
An IByteBuffer containing the new code that will be presented to the smart card during the change process to authenticate the user.
Flags [in]
Indicates whether the code is global or local, and whether the code should be enabled or disabled.
Flags are…
SC_FL_IHV_GLOBAL
SC_FL_IHV_LOCAL
SC_FL_IHV_ENABLE
SC_FL_IHV_DISABLE

lRef [in]
Smart card specific reference.

Return Values

The possible return values are the following:

Value Meaning
S_OK Operation completed successfully.
E_INVALIDARG Invalid parameter.
E_POINTER A bad pointer was passed in.
E_OUTOFMEMORY Out of memory.

Remarks

For a list of all the methods defined by the ISCardVerify interface, see ISCardVerify.

In addition to the COM error codes listed above, this interface may return a smart card error code if a smart card function was called to complete the request. For information on smart card error codes, see Smart Card Error Codes.

QuickInfo

  Windows NT: Use version 4.0 SP3 and later.
  Windows: Use Windows 95 OSR2.1.
  Windows CE: Unsupported.
  Header: Declared in scardcom.h.
  Import Library: scardcom.tlb (vendor-supplied).

See Also

ISCardVerify