CeCreateDirectory (RAPI)

  • Article

This function creates a new directory. CeCreateDirectory is a remote application interface (RAPI), which enables an application running on a desktop computer to make function calls on a Windows CE–based device.

BOOL CeCreateDirectory(
LPCWSTR lpPathName, 
LPSECURITY_ATTRIBUTES lpSecurityAttributes);

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 characters. This limit is related to how the CeCreateDirectory function parses paths.

    An application can transcend this limit and send in paths longer than MAX_PATH characters by prepending "\\?\" to the path. The "\\?\" tells the function to turn off path parsing; it lets paths longer than MAX_PATH be used with CeCreateDirectory. However, each component in the path cannot be more than MAX_PATH 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" and "\\?\UNC\bill_g_1\hotstuff\coolapps" is seen as "\\bill_g_1\hotstuff\coolapps."

  • lpSecurityAttributes
    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 versions 1.0 and 1.01, use the PegCreateDirectory function.

Requirements

Runs On Versions Defined in Include Link to
Windows CE OS 2.0 and later Rapi.h    

See Also

CeGetLastError, CeRapiGetError, CreateDirectory

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.