CeCreateDirectory (RAPI) (Windows CE 5.0)
This function creates a new directory.
CeCreateDirectory is a remote application programming interface (RAPI), which enables an application running on a desktop computer to make function calls on a Windows CE–based device.
BOOLCeCreateDirectory(LPCWSTRlpPathName, LPSECURITY_ATTRIBUTESlpSecurityAttributes);
Parameters
lpPathName
[in] Long pointer to a null-terminated string that specifies the path of the directory to be created.There is a default string size limit for paths of (MAX_PATH - 1) characters. This limit is related to how the CeCreateDirectory function parses paths.
An application can exceed this limit and use paths longer than (MAX_PATH - 1) characters by prepending \\?\ to the path. The \\?\ instructs CeCreateDirectory to disable path parsing, which then allows the use of paths longer than (MAX_PATH - 1). However, each component in the path cannot be more than (MAX_PATH - 1) characters long. This also works with Universal Naming Convention (UNC) names. The \\?\ is ignored as part of the path. For example, \\?\C:\myworld\private is seen as C:\myworld\private.
Note The NULL terminating character is considered part of the count - hence, the character length limit is one less than MAX_PATH.
- lpSecurityAttributes
[in] Ignored; set to NULL.
Return Values
Nonzero indicates success. Zero indicates failure. To determine if a function failed because of RAPI errors, call CeRapiGetError. To determine if a function failed because of non-RAPI errors, call CeGetLastError.
Remarks
When writing applications for Windows CE 1.0 and 1.01, use the PegCreateDirectory function.
Requirements
OS Versions: Windows CE 2.0 and later.
Header: Rapi.h.
Link Library: Rapi.lib.
See Also
RAPI Functions | CeGetLastError | CeRapiGetError | CreateDirectory
Send Feedback on this topic to the authors