CreateDirectoryFromAppW 函式 (fileapifromapp.h)
建立新目錄。 此函式的行為與CreateDirectory相同,不同之處在于此函式遵守應用程式安全性模型通用 Windows 平臺。
語法
WINSTORAGEAPI BOOL CreateDirectoryFromAppW(
LPCWSTR lpPathName,
LPSECURITY_ATTRIBUTES lpSecurityAttributes
) noexcept;
參數
lpPathName
要建立之目錄的路徑。
如需退出宣告 MAX_PATH 限制而不加上 「\\?\」 的詳細資訊,請參閱 命名檔案、路徑和命名空間 的一節以取得詳細資料。
lpSecurityAttributes
SECURITY_ATTRIBUTES結構的指標。 結構的 lpSecurityDescriptor 成員會指定新目錄的安全性描述元。 如果 lpSecurityAttributes 為 Null,目錄會取得預設的安全性描述元。 目錄預設安全性描述元中的 ACL 會繼承自其父目錄。
目的檔案系統必須支援檔案和目錄的安全性,這個參數才能生效。
傳回值
如果函式成功,則傳回非零的值。
如果此函式失敗,則傳回值為零。 若要取得擴充的錯誤資訊,請呼叫 GetLastError。 可能的錯誤包括下列各項。
傳回碼 | 描述 |
---|---|
ERROR_ALREADY_EXISTS | 指定的目錄已經存在。 |
ERROR_PATH_NOT_FOUND | 一或多個中繼目錄不存在;此函式只會在路徑中建立最終目錄。 |
需求
最低支援的用戶端 | Windows 10 (版本 1803) |
標頭 | fileapifromapp.h |