ChangeDir The ChangeDir method changes the current directory. HRESULT ChangeDir( [in] long lFlags, [in] long lDirID, [in[ unsigned char* pName, ); Requirement CreateContext, OpenDeviceParameters lFlags [in] A bit mask defining the options for directory. changing. You may use OR operation to enable one or more options : Flag Meaning EPAS_DIR_BY_ID When this flag is set, lDirID parameter contain ID of the directory to be changed into. This flag may be combined with EPAS_DIR_FROM_MF or EPAS_DIR_FROM_CUR_DF. lDirID must be a 16-bit directory ID. EPAS_DIR_BY_LONG_ID When this flag is set, lDirID parameter contain ID of the directory to be changed into. This flag may be combined with EPAS_DIR_FROM_MF, EPAS_DIR_FROM_CUR_DF, or EPAS_DIR_TO_PARENT. EPAS_DIR_BY_NAME When this flag is set, pName parameter contain Application Name of the directory to be changed into. This flag cannot combine with others. EPAS_DIR_BY_GUID When this flag is set, pName parameter contain Application GUID of the directory to be changed into. This flag cannot combine with others. EPAS_DIR_BY_GUID_STR When this flag is set, pName parameter contain Application GUID string of the directory to be changed into. This flag cannot combine with others. Additionally, one of the following flags can be used to specify the relative location: Flag Meaning EPAS_DIR_FROM_MF Change relative to root directory (Master File). This is the default option. EPAS_DIR_FROM_CUR_DF Change relative to current directory. EPAS_DIR_TO_PARENT Change to the parent directory of the current directory. This flag cannot be combined with others, lDirID and pDirName are ignored. lDirID [in] ID of the directory to change to. This parameter is only valid when one of the following flags is set: Flag Meaning EPAS_DIR_BY_ID lDirID contain a 16-bit directory ID in the range of 0 to 0xEFFF. EPAS_DIR_BY_LONG_ID lDirID contain a 32-bit directory ID in the range of 0 to 0xFFFFFFFF. If none of these flags are specified, then the lDirID parameter should be set to NULL. The lDirID parameter is ignored if EPAS_DIR_TO_PARENT is set. pName [in] Application Name or GUID of the directory to change to. This parameter is only valid when one of the following flags is set: Flag Meaning EPAS_DIR_BY_NAME Pointer to a NULL terminated string that is the Application Name assigned to the directory. Application Directory Name are case sensitive and global. Duplicates are not allowed. EPAS_DIR_BY_GUID Pointer to an array of 16 bytes that is the Application Directory GUID assigned to the directory. Application Directory GUID are global and duplicates are not allowed. EPAS_DIR_BY_GUID_STR Pointer to a NULL terminated string that is the Application Directory GUID assigned to the directory. The GUID string format is "{xxxxxxxx- xxxx - xxxx - xxxx - xxxxxxxxxxxx}". Application Directory GUID strings are global and duplicates are not allowed. Res Property access rights is required to read a file successfully. The granted access setting and file type is returned from the GetProperty methods. Return Values If the function succeeds, FT_SUCCESS returned. If read access to the file has not granted, FT_ACCESS_DENIED returned. For a list of all return codes, see Status Return Values.
The ChangeDir method changes the current directory. HRESULT
ChangeDir(
[in] long lFlags,
[in] long lDirID,
[in[ unsigned char* pName,
);
Requirement
CreateContext, OpenDeviceParameters
lFlags
[in] A bit mask defining the options for directory. changing. You may use OR operation to enable one or more options : Flag Meaning
EPAS_DIR_BY_ID When this flag is set, lDirID parameter contain ID of the directory to be changed into. This flag may be combined with EPAS_DIR_FROM_MF or EPAS_DIR_FROM_CUR_DF. lDirID must be a 16-bit directory ID.
EPAS_DIR_BY_LONG_ID When this flag is set, lDirID parameter contain ID of the directory to be changed into. This flag may be combined with EPAS_DIR_FROM_MF, EPAS_DIR_FROM_CUR_DF, or EPAS_DIR_TO_PARENT.
EPAS_DIR_BY_NAME When this flag is set, pName parameter contain Application Name of the directory to be changed into. This flag cannot combine with others.
EPAS_DIR_BY_GUID When this flag is set, pName parameter contain Application GUID of the directory to be changed into. This flag cannot combine with others.
EPAS_DIR_BY_GUID_STR When this flag is set, pName parameter contain Application GUID string of the directory to be changed into. This flag cannot combine with others.
Additionally, one of the following flags can be used to specify the relative location: Flag Meaning
EPAS_DIR_FROM_MF Change relative to root directory (Master File). This is the default option.
EPAS_DIR_FROM_CUR_DF Change relative to current directory.
EPAS_DIR_TO_PARENT Change to the parent directory of the current directory. This flag cannot be combined with others, lDirID and pDirName are ignored. lDirID
[in] ID of the directory to change to. This parameter is only valid when one of the following flags is set: Flag Meaning
EPAS_DIR_BY_ID lDirID contain a 16-bit directory ID in the range of 0 to 0xEFFF.
EPAS_DIR_BY_LONG_ID lDirID contain a 32-bit directory ID in the range of 0 to 0xFFFFFFFF.
If none of these flags are specified, then the lDirID parameter should be set to NULL.
The lDirID parameter is ignored if EPAS_DIR_TO_PARENT is set. pName
[in] Application Name or GUID of the directory to change to. This parameter is only valid when one of the following flags is set: Flag Meaning
EPAS_DIR_BY_NAME Pointer to a NULL terminated string that is the Application Name assigned to the directory. Application Directory Name are case sensitive and global. Duplicates are not allowed.
EPAS_DIR_BY_GUID Pointer to an array of 16 bytes that is the Application Directory GUID assigned to the directory. Application Directory GUID are global and duplicates are not allowed.
EPAS_DIR_BY_GUID_STR Pointer to a NULL terminated string that is the Application Directory GUID assigned to the directory. The GUID string format is "{xxxxxxxx- xxxx - xxxx - xxxx - xxxxxxxxxxxx}". Application Directory GUID strings are global and duplicates are not allowed. Res
Property access rights is required to read a file successfully. The granted access setting and file type is returned from the GetProperty methods. Return Values
If the function succeeds, FT_SUCCESS returned. If read access to the file has not granted, FT_ACCESS_DENIED returned. For a list of all return codes, see Status Return Values.