include/windows.storage.idl

   1 /*
   2  * Copyright 2023 Hans Leidekker for CodeWeavers
   3  *
   4  * This library is free software; you can redistribute it and/or
   5  * modify it under the terms of the GNU Lesser General Public
   6  * License as published by the Free Software Foundation; either
   7  * version 2.1 of the License, or (at your option) any later version.
   8  *
   9  * This library is distributed in the hope that it will be useful,
  10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12  * Lesser General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU Lesser General Public
  15  * License along with this library; if not, write to the Free Software
  16  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
  17  */
  18
  19 #ifdef __WIDL__
  20 #pragma winrt ns_prefix
  21 #endif
  22
  23 import "inspectable.idl";
  24 import "asyncinfo.idl";
  25 import "eventtoken.idl";
  26 import "windowscontracts.idl";
  27 import "windows.foundation.idl";
  28 import "windows.storage.fileproperties.idl";
  29 /* import "windows.storage.provider.idl"; */
  30 import "windows.storage.search.idl";
  31 import "windows.storage.streams.idl";
  32 import "windows.system.idl";
  33
  34 namespace Windows.Storage {
  35     typedef enum ApplicationDataCreateDisposition ApplicationDataCreateDisposition;
  36     typedef enum ApplicationDataLocality ApplicationDataLocality;
  37     typedef enum CreationCollisionOption CreationCollisionOption;
  38     typedef enum FileAccessMode FileAccessMode;
  39     typedef enum FileAttributes FileAttributes;
  40     typedef enum KnownFolderId KnownFolderId;
  41     typedef enum KnownFoldersAccessStatus KnownFoldersAccessStatus;
  42     typedef enum NameCollisionOption NameCollisionOption;
  43     typedef enum StorageDeleteOption StorageDeleteOption;
  44     typedef enum StorageItemTypes StorageItemTypes;
  45
  46     interface IApplicationData;
  47     interface IApplicationData2;
  48     interface IApplicationData3;
  49     interface IApplicationDataContainer;
  50     interface IApplicationDataStatics;
  51     interface IApplicationDataStatics2;
  52     interface IKnownFoldersCameraRollStatics;
  53     interface IKnownFoldersPlaylistsStatics;
  54     interface IKnownFoldersSavedPicturesStatics;
  55     interface IKnownFoldersStatics;
  56     interface IKnownFoldersStatics2;
  57     interface IKnownFoldersStatics3;
  58     interface IKnownFoldersStatics4;
  59     interface ISetVersionDeferral;
  60     interface ISetVersionRequest;
  61     interface IStorageFolder;
  62     interface IStorageFolderStatics;
  63     interface IStorageFolderStatics2;
  64     interface IStorageFileStatics;
  65     interface IStorageFileStatics2;
  66     interface IStorageItem;
  67
  68     runtimeclass ApplicationData;
  69     runtimeclass ApplicationDataContainer;
  70     runtimeclass KnownFolders;
  71     runtimeclass SetVersionDeferral;
  72     runtimeclass SetVersionRequest;
  73     runtimeclass StorageFolder;
  74     runtimeclass StorageFile;
  75     runtimeclass StorageStreamTransaction;
  76
  77     declare {
  78         interface Windows.Foundation.Collections.IKeyValuePair<HSTRING, Windows.Storage.ApplicationDataContainer *>;
  79         interface Windows.Foundation.Collections.IIterable<Windows.Foundation.Collections.IKeyValuePair<HSTRING, Windows.Storage.ApplicationDataContainer *> *>;
  80         interface Windows.Foundation.Collections.IIterator<Windows.Foundation.Collections.IKeyValuePair<HSTRING, Windows.Storage.ApplicationDataContainer *> *>;
  81         interface Windows.Foundation.Collections.IMapView<HSTRING, Windows.Storage.ApplicationDataContainer *>;
  82         interface Windows.Foundation.Collections.IVectorView<Windows.Storage.IStorageItem *>;
  83         interface Windows.Foundation.Collections.IVectorView<Windows.Storage.StorageFile *>;
  84         interface Windows.Foundation.Collections.IVectorView<Windows.Storage.StorageFolder *>;
  85         interface Windows.Foundation.AsyncOperationCompletedHandler<Windows.Foundation.Collections.IVectorView<Windows.Storage.IStorageItem *> *>;
  86         interface Windows.Foundation.AsyncOperationCompletedHandler<Windows.Foundation.Collections.IVectorView<Windows.Storage.StorageFile *> *>;
  87         interface Windows.Foundation.AsyncOperationCompletedHandler<Windows.Foundation.Collections.IVectorView<Windows.Storage.StorageFolder *> *>;
  88         interface Windows.Foundation.AsyncOperationCompletedHandler<Windows.Storage.ApplicationData *>;
  89         interface Windows.Foundation.AsyncOperationCompletedHandler<Windows.Storage.KnownFoldersAccessStatus>;
  90         interface Windows.Foundation.AsyncOperationCompletedHandler<Windows.Storage.IStorageItem *>;
  91         interface Windows.Foundation.AsyncOperationCompletedHandler<Windows.Storage.StorageFile *>;
  92         interface Windows.Foundation.AsyncOperationCompletedHandler<Windows.Storage.StorageFolder *>;
  93         interface Windows.Foundation.AsyncOperationCompletedHandler<Windows.Storage.StorageStreamTransaction *>;
  94         interface Windows.Foundation.IAsyncOperation<Windows.Foundation.Collections.IVectorView<Windows.Storage.IStorageItem *> *>;
  95         interface Windows.Foundation.IAsyncOperation<Windows.Foundation.Collections.IVectorView<Windows.Storage.StorageFile *> *>;
  96         interface Windows.Foundation.IAsyncOperation<Windows.Foundation.Collections.IVectorView<Windows.Storage.StorageFolder *> *>;
  97         interface Windows.Foundation.IAsyncOperation<Windows.Storage.ApplicationData *>;
  98         interface Windows.Foundation.IAsyncOperation<Windows.Storage.KnownFoldersAccessStatus>;
  99         interface Windows.Foundation.IAsyncOperation<Windows.Storage.IStorageItem *>;
 100         interface Windows.Foundation.IAsyncOperation<Windows.Storage.StorageFile *>;
 101         interface Windows.Foundation.IAsyncOperation<Windows.Storage.StorageFolder *>;
 102         interface Windows.Foundation.IAsyncOperation<Windows.Storage.StorageStreamTransaction *>;
 103         interface Windows.Foundation.TypedEventHandler<Windows.Storage.ApplicationData *, IInspectable *>;
 104     }
 105
 106     [
 107         contract(Windows.Foundation.UniversalApiContract, 1.0)
 108     ]
 109     enum ApplicationDataCreateDisposition
 110     {
 111         Always   = 0,
 112         Existing = 1,
 113     };
 114
 115     [
 116         contract(Windows.Foundation.UniversalApiContract, 1.0)
 117     ]
 118     enum ApplicationDataLocality
 119     {
 120         Local       = 0,
 121         Roaming     = 1,
 122         Temporary   = 2,
 123         LocalCache  = 3,
 124         [contract(Windows.Foundation.UniversalApiContract, 12.0)]
 125         SharedLocal = 4,
 126     };
 127
 128     [
 129         contract(Windows.Foundation.UniversalApiContract, 1.0)
 130     ]
 131     enum CreationCollisionOption
 132     {
 133         GenerateUniqueName = 0,
 134         ReplaceExisting    = 1,
 135         FailIfExists       = 2,
 136         OpenIfExists       = 3,
 137     };
 138
 139     [
 140         contract(Windows.Foundation.UniversalApiContract, 1.0)
 141     ]
 142     enum FileAccessMode
 143     {
 144         Read      = 0,
 145         ReadWrite = 1,
 146     };
 147
 148     [
 149         contract(Windows.Foundation.UniversalApiContract, 1.0),
 150         flags
 151     ]
 152     enum FileAttributes
 153     {
 154         Normal            = 0x0,
 155         ReadOnly          = 0x1,
 156         Directory         = 0x10,
 157         Archive           = 0x20,
 158         Temporary         = 0x100,
 159         [contract(Windows.Foundation.UniversalApiContract, 1.0)]
 160         LocallyIncomplete = 0x200,
 161     };
 162
 163     [
 164         contract(Windows.Foundation.UniversalApiContract, 2.0)
 165     ]
 166     enum KnownFolderId
 167     {
 168         AppCaptures        = 0,
 169         CameraRoll         = 1,
 170         DocumentsLibrary   = 2,
 171         HomeGroup          = 3,
 172         MediaServerDevices = 4,
 173         MusicLibrary       = 5,
 174         Objects3D          = 6,
 175         PicturesLibrary    = 7,
 176         Playlists          = 8,
 177         RecordedCalls      = 9,
 178         RemovableDevices   = 10,
 179         SavedPictures      = 11,
 180         Screenshots        = 12,
 181         VideosLibrary      = 13,
 182         [contract(Windows.Foundation.UniversalApiContract, 4.0)]
 183         AllAppMods         = 14,
 184         [contract(Windows.Foundation.UniversalApiContract, 4.0)]
 185         CurrentAppMods     = 15,
 186         [contract(Windows.Foundation.UniversalApiContract, 11.0)]
 187         DownloadsFolder    = 16,
 188     };
 189
 190     [
 191         contract(Windows.Foundation.UniversalApiContract, 10.0)
 192     ]
 193     enum KnownFoldersAccessStatus
 194     {
 195         DeniedBySystem      = 0,
 196         NotDeclaredByApp    = 1,
 197         DeniedByUser        = 2,
 198         UserPromptRequired  = 3,
 199         Allowed             = 4,
 200         [contract(Windows.Foundation.UniversalApiContract, 11.0)]
 201         AllowedPerAppFolder = 5,
 202     };
 203
 204     [
 205         contract(Windows.Foundation.UniversalApiContract, 1.0)
 206     ]
 207     enum NameCollisionOption
 208     {
 209         GenerateUniqueName = 0,
 210         ReplaceExisting    = 1,
 211         FailIfExists       = 2,
 212     };
 213
 214     [
 215         contract(Windows.Foundation.UniversalApiContract, 1.0)
 216     ]
 217     enum StorageDeleteOption
 218     {
 219         Default         = 0,
 220         PermanentDelete = 1,
 221     };
 222
 223     [
 224         contract(Windows.Foundation.UniversalApiContract, 1.0),
 225         flags
 226     ]
 227     enum StorageItemTypes
 228     {
 229         None   = 0x0,
 230         File   = 0x1,
 231         Folder = 0x2,
 232     };
 233
 234     [
 235         contract(Windows.Foundation.UniversalApiContract, 1.0),
 236         uuid(a05791e6-cc9f-4687-acab-a364fd785463)
 237     ]
 238     delegate HRESULT ApplicationDataSetVersionHandler([in] Windows.Storage.SetVersionRequest *version);
 239
 240     [
 241         contract(Windows.Foundation.UniversalApiContract, 1.0),
 242         exclusiveto(Windows.Storage.ApplicationData),
 243         uuid(c3da6fb7-b744-4b45-b0b8-223a0938d0dc)
 244     ]
 245     interface IApplicationData : IInspectable
 246     {
 247         [propget] HRESULT Version([out, retval] UINT32 *value);
 248         HRESULT SetVersionAsync(
 249             [in] UINT32 version,
 250             [in] Windows.Storage.ApplicationDataSetVersionHandler *handler,
 251             [out, retval] Windows.Foundation.IAsyncAction **operation
 252         );
 253         [overload("ClearAsync")]
 254         HRESULT ClearAllAsync(
 255             [out, retval] Windows.Foundation.IAsyncAction **operation
 256         );
 257         [overload("ClearAsync")]
 258         HRESULT ClearAsync(
 259             [in] Windows.Storage.ApplicationDataLocality locality,
 260             [out, retval] Windows.Foundation.IAsyncAction **operation
 261         );
 262         [propget] HRESULT LocalSettings([out, retval] Windows.Storage.ApplicationDataContainer **value);
 263         [propget] HRESULT RoamingSettings([out, retval] Windows.Storage.ApplicationDataContainer **value);
 264         [propget] HRESULT LocalFolder([out, retval] Windows.Storage.StorageFolder **value);
 265         [propget] HRESULT RoamingFolder([out, retval] Windows.Storage.StorageFolder **value);
 266         [propget] HRESULT TemporaryFolder([out, retval] Windows.Storage.StorageFolder **value);
 267         [eventadd] HRESULT DataChanged(
 268             [in] Windows.Foundation.TypedEventHandler<Windows.Storage.ApplicationData *, IInspectable *> *handler,
 269             [out, retval] EventRegistrationToken *token
 270         );
 271         [eventremove] HRESULT DataChanged([in] EventRegistrationToken token);
 272         HRESULT SignalDataChanged();
 273         [propget] HRESULT RoamingStorageQuota([out, retval] UINT64 *value);
 274     }
 275
 276     [
 277         contract(Windows.Foundation.UniversalApiContract, 1.0),
 278         exclusiveto(Windows.Storage.ApplicationData),
 279         uuid(9e65cd69-0ba3-4e32-be29-b02de6607638)
 280     ]
 281     interface IApplicationData2 : IInspectable
 282     {
 283         [propget] HRESULT LocalCacheFolder([out, retval] Windows.Storage.StorageFolder **value);
 284     }
 285
 286     [
 287         contract(Windows.Foundation.UniversalApiContract, 1.0),
 288         exclusiveto(Windows.Storage.ApplicationData),
 289         uuid(dc222cf4-2772-4c1d-aa2c-c9f743ade8d1)
 290     ]
 291     interface IApplicationData3 : IInspectable
 292     {
 293         HRESULT GetPublisherCacheFolder(
 294             [in] HSTRING folder_name,
 295             [out, retval] Windows.Storage.StorageFolder **value
 296         );
 297         HRESULT ClearPublisherCacheFolderAsync(
 298             [in] HSTRING folder_name,
 299             [out, retval] Windows.Foundation.IAsyncAction **operation
 300         );
 301         [propget] HRESULT SharedLocalFolder([out, retval] Windows.Storage.StorageFolder **value);
 302     }
 303
 304     [
 305         contract(Windows.Foundation.UniversalApiContract, 1.0),
 306         exclusiveto(Windows.Storage.ApplicationDataContainer),
 307         uuid(c5aefd1e-f467-40ba-8566-ab640a441e1d)
 308     ]
 309     interface IApplicationDataContainer : IInspectable
 310     {
 311         [propget] HRESULT Name([out, retval] HSTRING *value);
 312         [propget] HRESULT Locality([out, retval] Windows.Storage.ApplicationDataLocality *value);
 313         [propget] HRESULT Values([out, retval] Windows.Foundation.Collections.IPropertySet **value);
 314         [propget] HRESULT Containers([out, retval] Windows.Foundation.Collections.IMapView<HSTRING, Windows.Storage.ApplicationDataContainer *> **value);
 315         HRESULT CreateContainer(
 316             [in] HSTRING name,
 317             [in] Windows.Storage.ApplicationDataCreateDisposition disposition,
 318             [out, retval] Windows.Storage.ApplicationDataContainer **container
 319         );
 320         HRESULT DeleteContainer([in] HSTRING name);
 321     }
 322
 323     [
 324         contract(Windows.Foundation.UniversalApiContract, 1.0),
 325         exclusiveto(Windows.Storage.ApplicationData),
 326         uuid(5612147b-e843-45e3-94d8-06169e3c8e17)
 327     ]
 328     interface IApplicationDataStatics : IInspectable
 329     {
 330         [propget] HRESULT Current([out, retval] Windows.Storage.ApplicationData **value);
 331     }
 332
 333     [
 334         contract(Windows.Foundation.UniversalApiContract, 1.0),
 335         exclusiveto(Windows.Storage.ApplicationData),
 336         uuid(cd606211-cf49-40a4-a47c-c7f0dbba8107)
 337     ]
 338     interface IApplicationDataStatics2 : IInspectable
 339     {
 340         HRESULT GetForUserAsync(
 341             [in] Windows.System.User *user,
 342             [out, retval] Windows.Foundation.IAsyncOperation<Windows.Storage.ApplicationData *> **operation
 343         );
 344     }
 345
 346     [
 347         contract(Windows.Foundation.UniversalApiContract, 1.0),
 348         exclusiveto(Windows.Storage.KnownFolders),
 349         uuid(5d115e66-27e8-492f-b8e5-2f90896cd4cd)
 350     ]
 351     interface IKnownFoldersCameraRollStatics : IInspectable
 352     {
 353         [propget] HRESULT CameraRoll([out, retval] Windows.Storage.StorageFolder **value);
 354     }
 355
 356     [
 357         contract(Windows.Foundation.UniversalApiContract, 1.0),
 358         exclusiveto(Windows.Storage.KnownFolders),
 359         uuid(dad5ecd6-306f-4d6a-b496-46ba8eb106ce)
 360     ]
 361     interface IKnownFoldersPlaylistsStatics : IInspectable
 362     {
 363         [propget] HRESULT Playlists([out, retval] Windows.Storage.StorageFolder **value);
 364     }
 365
 366     [
 367         contract(Windows.Foundation.UniversalApiContract, 1.0),
 368         exclusiveto(Windows.Storage.KnownFolders),
 369         uuid(055c93ea-253d-467c-b6ca-a97da1e9a18d)
 370     ]
 371     interface IKnownFoldersSavedPicturesStatics : IInspectable
 372     {
 373         [propget] HRESULT SavedPictures([out, retval] Windows.Storage.StorageFolder **value);
 374     }
 375
 376     [
 377         contract(Windows.Foundation.UniversalApiContract, 1.0),
 378         exclusiveto(Windows.Storage.KnownFolders),
 379         uuid(5a2a7520-4802-452d-9ad9-4351ada7ec35)
 380     ]
 381     interface IKnownFoldersStatics : IInspectable
 382     {
 383         [propget] HRESULT MusicLibrary([out, retval] Windows.Storage.StorageFolder **value);
 384         [propget] HRESULT PicturesLibrary([out, retval] Windows.Storage.StorageFolder **value);
 385         [propget] HRESULT VideosLibrary([out, retval] Windows.Storage.StorageFolder **value);
 386         [propget] HRESULT DocumentsLibrary([out, retval] Windows.Storage.StorageFolder **value);
 387         [propget] HRESULT HomeGroup([out, retval] Windows.Storage.StorageFolder **value);
 388         [propget] HRESULT RemovableDevices([out, retval] Windows.Storage.StorageFolder **value);
 389         [propget] HRESULT MediaServerDevices([out, retval] Windows.Storage.StorageFolder **value);
 390     }
 391
 392     [
 393         contract(Windows.Foundation.UniversalApiContract, 1.0),
 394         exclusiveto(Windows.Storage.KnownFolders),
 395         uuid(194bd0cd-cf6e-4d07-9d53-e9163a2536e9)
 396     ]
 397     interface IKnownFoldersStatics2 : IInspectable
 398     {
 399         [propget] HRESULT Objects3D([out, retval] Windows.Storage.StorageFolder **value);
 400         [propget] HRESULT AppCaptures([out, retval] Windows.Storage.StorageFolder **value);
 401         [propget] HRESULT RecordedCalls([out, retval] Windows.Storage.StorageFolder **value);
 402     }
 403
 404     [
 405         contract(Windows.Foundation.UniversalApiContract, 2.0),
 406         exclusiveto(Windows.Storage.KnownFolders),
 407         uuid(c5194341-9742-4ed5-823d-fc1401148764)
 408     ]
 409     interface IKnownFoldersStatics3 : IInspectable
 410     {
 411         HRESULT GetFolderForUserAsync(
 412             [in] Windows.System.User *user,
 413             [in] Windows.Storage.KnownFolderId folder_id,
 414             [out, retval] Windows.Foundation.IAsyncOperation<Windows.Storage.StorageFolder *> **operation
 415         );
 416     }
 417
 418     [
 419         contract(Windows.Foundation.UniversalApiContract, 10.0),
 420         exclusiveto(Windows.Storage.KnownFolders),
 421         uuid(1722e6bf-9ff9-4b21-bed5-90ecb13a192e)
 422     ]
 423     interface IKnownFoldersStatics4 : IInspectable
 424     {
 425         HRESULT RequestAccessAsync(
 426             [in] Windows.Storage.KnownFolderId folder_id,
 427             [out, retval] Windows.Foundation.IAsyncOperation<Windows.Storage.KnownFoldersAccessStatus> **operation
 428         );
 429         HRESULT RequestAccessForUserAsync(
 430             [in] Windows.System.User *user,
 431             [in] Windows.Storage.KnownFolderId folder_id,
 432             [out, retval] Windows.Foundation.IAsyncOperation<Windows.Storage.KnownFoldersAccessStatus> **operation
 433         );
 434         HRESULT GetFolderAsync(
 435             [in] Windows.Storage.KnownFolderId folder_id,
 436             [out, retval] Windows.Foundation.IAsyncOperation<Windows.Storage.StorageFolder *> **operation
 437         );
 438     }
 439
 440     [
 441         contract(Windows.Foundation.UniversalApiContract, 1.0),
 442         exclusiveto(Windows.Storage.SetVersionDeferral),
 443         uuid(033508a2-781a-437a-b078-3f32badcfe47)
 444     ]
 445     interface ISetVersionDeferral : IInspectable
 446     {
 447         HRESULT Complete();
 448     }
 449
 450     [
 451         contract(Windows.Foundation.UniversalApiContract, 1.0),
 452         exclusiveto(Windows.Storage.SetVersionRequest),
 453         uuid(b9c76b9b-1056-4e69-8330-162619956f9b)
 454     ]
 455     interface ISetVersionRequest : IInspectable
 456     {
 457         [propget] HRESULT CurrentVersion([out, retval] UINT32 *version);
 458         [propget] HRESULT DesiredVersion([out, retval] UINT32 *version);
 459         HRESULT GetDeferral([out, retval] Windows.Storage.SetVersionDeferral **deferral);
 460     }
 461
 462     [
 463         contract(Windows.Foundation.UniversalApiContract, 1.0),
 464         uuid(fa3f6186-4214-428c-a64c-14c9ac7315ea)
 465     ]
 466     interface IStorageFile : IInspectable
 467         requires Windows.Storage.IStorageItem,
 468                  Windows.Storage.Streams.IRandomAccessStreamReference,
 469                  Windows.Storage.Streams.IInputStreamReference
 470     {
 471         [propget] HRESULT FileType([out, retval] HSTRING *value);
 472         [propget] HRESULT ContentType([out, retval] HSTRING *value);
 473         HRESULT OpenAsync(
 474             [in] Windows.Storage.FileAccessMode mode,
 475             [out, retval] Windows.Foundation.IAsyncOperation<Windows.Storage.Streams.IRandomAccessStream *> **operation
 476         );
 477         HRESULT OpenTransactedWriteAsync([out, retval] Windows.Foundation.IAsyncOperation<Windows.Storage.StorageStreamTransaction *> **operation);
 478         [overload("CopyAsync")]
 479         HRESULT CopyOverloadDefaultNameAndOptions(
 480             [in] Windows.Storage.IStorageFolder *folder,
 481             [out, retval] Windows.Foundation.IAsyncOperation<Windows.Storage.StorageFile *> **operation
 482         );
 483         [overload("CopyAsync")]
 484         HRESULT CopyOverloadDefaultOptions(
 485             [in] Windows.Storage.IStorageFolder *folder,
 486             [in] HSTRING name,
 487             [out, retval] Windows.Foundation.IAsyncOperation<Windows.Storage.StorageFile *> **operation);
 488         [overload("CopyAsync")]
 489         HRESULT CopyOverload(
 490             [in] Windows.Storage.IStorageFolder *folder,
 491             [in] HSTRING name,
 492             [in] Windows.Storage.NameCollisionOption option,
 493             [out, retval] Windows.Foundation.IAsyncOperation<Windows.Storage.StorageFile *> **operation
 494         );
 495         HRESULT CopyAndReplaceAsync([in] Windows.Storage.IStorageFile *file, [out, retval] Windows.Foundation.IAsyncAction **operation);
 496         [overload("MoveAsync")]
 497         HRESULT MoveOverloadDefaultNameAndOptions([in] Windows.Storage.IStorageFolder *folder, [out, retval] Windows.Foundation.IAsyncAction **operation);
 498         [overload("MoveAsync")]
 499         HRESULT MoveOverloadDefaultOptions(
 500             [in] Windows.Storage.IStorageFolder *folder,
 501             [in] HSTRING name,
 502             [out, retval] Windows.Foundation.IAsyncAction **operation
 503         );
 504         [overload("MoveAsync")]
 505         HRESULT MoveOverload(
 506             [in] Windows.Storage.IStorageFolder *folder,
 507             [in] HSTRING name,
 508             [in] Windows.Storage.NameCollisionOption option,
 509             [out, retval] Windows.Foundation.IAsyncAction **operation);
 510         HRESULT MoveAndReplaceAsync([in] Windows.Storage.IStorageFile *file, [out, retval] Windows.Foundation.IAsyncAction **operation);
 511     }
 512
 513     [
 514         contract(Windows.Foundation.UniversalApiContract, 1.0),
 515         uuid(72d1cb78-b3ef-4f75-a80b-6fd9dae2944b)
 516     ]
 517     interface IStorageFolder : IInspectable
 518         requires Windows.Storage.IStorageItem
 519     {
 520         [overload("CreateFileAsync")]
 521         HRESULT CreateFileAsyncOverloadDefaultOptions(
 522             [in] HSTRING name,
 523             [out, retval] Windows.Foundation.IAsyncOperation<Windows.Storage.StorageFile *> **operation
 524         );
 525         [overload("CreateFileAsync")]
 526         HRESULT CreateFileAsync(
 527             [in] HSTRING name,
 528             [in] Windows.Storage.CreationCollisionOption options,
 529             [out, retval] Windows.Foundation.IAsyncOperation<Windows.Storage.StorageFile *> **operation
 530         );
 531         [overload("CreateFolderAsync")]
 532         HRESULT CreateFolderAsyncOverloadDefaultOptions(
 533             [in] HSTRING name,
 534             [out, retval] Windows.Foundation.IAsyncOperation<Windows.Storage.StorageFolder *> **operation
 535         );
 536         [overload("CreateFolderAsync")]
 537         HRESULT CreateFolderAsync(
 538             [in] HSTRING name,
 539             [in] Windows.Storage.CreationCollisionOption options,
 540             [out, retval] Windows.Foundation.IAsyncOperation<Windows.Storage.StorageFolder *> **operation
 541         );
 542         HRESULT GetFileAsync([in] HSTRING name, [out, retval] Windows.Foundation.IAsyncOperation<Windows.Storage.StorageFile *> **operation);
 543         HRESULT GetFolderAsync([in] HSTRING name, [out, retval] Windows.Foundation.IAsyncOperation<Windows.Storage.StorageFolder *> **operation);
 544         HRESULT GetItemAsync([in] HSTRING name, [out, retval] Windows.Foundation.IAsyncOperation<Windows.Storage.IStorageItem *> **operation);
 545         [overload("GetFilesAsync")]
 546         HRESULT GetFilesAsyncOverloadDefaultOptionsStartAndCount(
 547             [out, retval] Windows.Foundation.IAsyncOperation<Windows.Foundation.Collections.IVectorView<Windows.Storage.StorageFile *> *> **operation
 548         );
 549         [overload("GetFoldersAsync")]
 550         HRESULT GetFoldersAsyncOverloadDefaultOptionsStartAndCount(
 551             [out, retval] Windows.Foundation.IAsyncOperation<Windows.Foundation.Collections.IVectorView<Windows.Storage.StorageFolder *> *> **operation
 552         );
 553         [overload("GetItemsAsync")]
 554         HRESULT GetItemsAsyncOverloadDefaultStartAndCount(
 555             [out, retval] Windows.Foundation.IAsyncOperation<Windows.Foundation.Collections.IVectorView<Windows.Storage.IStorageItem *> *> **operation
 556         );
 557     }
 558
 559     [
 560         contract(Windows.Foundation.UniversalApiContract, 1.0),
 561         uuid(4207a996-ca2f-42f7-bde8-8b10457a7f30)
 562     ]
 563     interface IStorageItem : IInspectable
 564     {
 565         [overload("RenameAsync")]
 566         HRESULT RenameAsyncOverloadDefaultOptions([in] HSTRING name, [out, retval] Windows.Foundation.IAsyncAction **operation);
 567         [overload("RenameAsync")]
 568         HRESULT RenameAsync([in] HSTRING name, [in] Windows.Storage.NameCollisionOption option, [out, retval] Windows.Foundation.IAsyncAction **operation);
 569         [overload("DeleteAsync")]
 570         HRESULT DeleteAsyncOverloadDefaultOptions([out, retval] Windows.Foundation.IAsyncAction **operation);
 571         [overload("DeleteAsync")]
 572         HRESULT DeleteAsync([in] Windows.Storage.StorageDeleteOption option, [out, retval] Windows.Foundation.IAsyncAction **operation);
 573         HRESULT GetBasicPropertiesAsync([out, retval] Windows.Foundation.IAsyncOperation<Windows.Storage.FileProperties.BasicProperties *> **operation);
 574         [propget] HRESULT Name([out, retval] HSTRING *value);
 575         [propget] HRESULT Path([out, retval] HSTRING *value);
 576         [propget] HRESULT Attributes([out, retval] Windows.Storage.FileAttributes *value);
 577         [propget] HRESULT DateCreated([out, retval] Windows.Foundation.DateTime *value);
 578         HRESULT IsOfType([in] Windows.Storage.StorageItemTypes type, [out, retval] boolean *value);
 579     }
 580
 581     [
 582         contract(Windows.Foundation.UniversalApiContract, 1.0),
 583         exclusiveto(Windows.Storage.StorageStreamTransaction),
 584         uuid(f67cf363-a53d-4d94-ae2c-67232d93acdd)
 585     ]
 586     interface IStorageStreamTransaction : IInspectable
 587         requires Windows.Foundation.IClosable
 588     {
 589         [propget] HRESULT Stream([out, retval] Windows.Storage.Streams.IRandomAccessStream **value);
 590         HRESULT CommitAsync([out, retval] Windows.Foundation.IAsyncAction **operation);
 591     }
 592
 593     [
 594         contract(Windows.Foundation.UniversalApiContract, 1.0),
 595         marshaling_behavior(agile),
 596         static(Windows.Storage.IApplicationDataStatics, Windows.Foundation.UniversalApiContract, 1.0),
 597         static(Windows.Storage.IApplicationDataStatics2, Windows.Foundation.UniversalApiContract, 1.0),
 598         threading(mta)
 599     ]
 600     runtimeclass ApplicationData
 601     {
 602         [default] interface Windows.Storage.IApplicationData;
 603         [contract(Windows.Foundation.UniversalApiContract, 1.0)] interface Windows.Storage.IApplicationData2;
 604         [contract(Windows.Foundation.UniversalApiContract, 1.0)] interface Windows.Storage.IApplicationData3;
 605         [contract(Windows.Foundation.UniversalApiContract, 12.0)] interface Windows.Foundation.IClosable;
 606     }
 607
 608     [
 609         contract(Windows.Foundation.UniversalApiContract, 1.0),
 610         marshaling_behavior(agile)
 611     ]
 612     runtimeclass ApplicationDataContainer
 613     {
 614         [default] interface Windows.Storage.IApplicationDataContainer;
 615         [contract(Windows.Foundation.UniversalApiContract, 12.0)] interface Windows.Foundation.IClosable;
 616     }
 617
 618     [
 619         contract(Windows.Foundation.UniversalApiContract, 1.0),
 620         marshaling_behavior(agile),
 621         static(Windows.Storage.IKnownFoldersCameraRollStatics, Windows.Foundation.UniversalApiContract, 1.0),
 622         static(Windows.Storage.IKnownFoldersPlaylistsStatics, Windows.Foundation.UniversalApiContract, 1.0),
 623         static(Windows.Storage.IKnownFoldersSavedPicturesStatics, Windows.Foundation.UniversalApiContract, 1.0),
 624         static(Windows.Storage.IKnownFoldersStatics, Windows.Foundation.UniversalApiContract, 1.0),
 625         static(Windows.Storage.IKnownFoldersStatics2, Windows.Foundation.UniversalApiContract, 1.0),
 626         static(Windows.Storage.IKnownFoldersStatics3, Windows.Foundation.UniversalApiContract, 2.0),
 627         static(Windows.Storage.IKnownFoldersStatics4, Windows.Foundation.UniversalApiContract, 10.0)
 628     ]
 629     runtimeclass KnownFolders
 630     {
 631     }
 632
 633     [
 634         contract(Windows.Foundation.UniversalApiContract, 1.0),
 635         marshaling_behavior(agile)
 636     ]
 637     runtimeclass SetVersionDeferral
 638     {
 639         [default] interface Windows.Storage.ISetVersionDeferral;
 640     }
 641
 642     [
 643         contract(Windows.Foundation.UniversalApiContract, 1.0),
 644         marshaling_behavior(agile)
 645     ]
 646     runtimeclass SetVersionRequest
 647     {
 648         [default] interface Windows.Storage.ISetVersionRequest;
 649     }
 650
 651     [
 652         contract(Windows.Foundation.UniversalApiContract, 1.0),
 653         static(Windows.Storage.IStorageFileStatics, Windows.Foundation.UniversalApiContract, 1.0),
 654         static(Windows.Storage.IStorageFileStatics2, Windows.Foundation.UniversalApiContract, 10.0)
 655     ]
 656     runtimeclass StorageFile
 657     {
 658         [default] interface Windows.Storage.IStorageFile;
 659         interface Windows.Storage.Streams.IInputStreamReference;
 660         interface Windows.Storage.Streams.IRandomAccessStreamReference;
 661         interface Windows.Storage.IStorageItem;
 662         interface Windows.Storage.IStorageItemProperties;
 663         [contract(Windows.Foundation.UniversalApiContract, 1.0)] interface Windows.Storage.IStorageItemProperties2;
 664         [contract(Windows.Foundation.UniversalApiContract, 1.0)] interface Windows.Storage.IStorageItem2;
 665         [contract(Windows.Foundation.UniversalApiContract, 1.0)] interface Windows.Storage.IStorageItemPropertiesWithProvider;
 666         [contract(Windows.Foundation.UniversalApiContract, 1.0)] interface Windows.Storage.IStorageFilePropertiesWithAvailability;
 667         [contract(Windows.Foundation.UniversalApiContract, 1.0)] interface Windows.Storage.IStorageFile2;
 668     }
 669
 670     [
 671         contract(Windows.Foundation.UniversalApiContract, 1.0),
 672         static(Windows.Storage.IStorageFolderStatics, Windows.Foundation.UniversalApiContract, 1.0),
 673         static(Windows.Storage.IStorageFolderStatics2, Windows.Foundation.UniversalApiContract, 10.0)
 674     ]
 675     runtimeclass StorageFolder
 676     {
 677         [default] interface Windows.Storage.IStorageFolder;
 678         interface Windows.Storage.IStorageItem;
 679         interface Windows.Storage.Search.IStorageFolderQueryOperations;
 680         interface Windows.Storage.IStorageItemProperties;
 681         [contract(Windows.Foundation.UniversalApiContract, 1.0)] interface Windows.Storage.IStorageItemProperties2;
 682         [contract(Windows.Foundation.UniversalApiContract, 1.0)] interface Windows.Storage.IStorageItem2;
 683         [contract(Windows.Foundation.UniversalApiContract, 1.0)] interface Windows.Storage.IStorageFolder2;
 684         [contract(Windows.Foundation.UniversalApiContract, 1.0)] interface Windows.Storage.IStorageItemPropertiesWithProvider;
 685         [contract(Windows.Foundation.UniversalApiContract, 6.0)] interface Windows.Storage.IStorageFolder3;
 686     }
 687
 688     [
 689         contract(Windows.Foundation.UniversalApiContract, 1.0)
 690     ]
 691     runtimeclass StorageStreamTransaction
 692     {
 693         [default] interface Windows.Storage.IStorageStreamTransaction;
 694         interface Windows.Foundation.IClosable;
 695     }
 696 }