CeCreateDirectory (RAPI)

A version of this page is also available for

4/8/2010

This function creates a new directory on a remote Windows Embedded CE–based device.

Syntax

BOOL CeCreateDirectory(
  LPCWSTR lpPathName,
  LPSECURITY_ATTRIBUTES lpSecurityAttributes
);

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. 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.

Nonzero indicates success. Zero indicates failure. To get extended error information, call CeGetLastError and CeRapiGetError.

Header	rapi.h
Library	rapi.lib
Windows Embedded CE	Windows CE 3.0 and later
Windows Mobile	Pocket PC 2000 and later, Smartphone 2002 and later