IRAPISession::CeCreateDirectory

A version of this page is also available for

4/8/2010

This method 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 IRAPISession::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 IRAPISession::CeGetLastError and IRAPISession::CeRapiGetError.

Header	rapi2.h
Library	ole32.lib, rapiuuid.lib
Windows Embedded CE	Windows Embedded CE 6.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later