ISCardFileAccess::ChangeDir

The ChangeDir method changes the current smart card directory to the new specified directory.

HRESULT ChangeDir(
  REFTYPE refType,
  BSTR bstrNewDir
);

Parameters

refType [in]
Specifies the type of reference used in bstrNewDir as follows:

SC_TYPE_BY_NAME

SC_TYPE_BY_ID

SC_TYPE_BY_SHORT

SC_TYPE_BY_ANY

bstrNewDir [in]
Specifies a file/directory name (by refType) to select.

Return Values

The possible return values are the following:

Value Meaning
S_OK Operation completed successfully.
E_INVALIDARG Invalid parameter.
E_OUTOFMEMORY Out of memory.

Remarks

To get an absolute path to the currently selected directory, call GetCurrentDir.

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

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

GetCurrentDir, ISCardFileAccess