IStorageFolderHandleAccess::Create method (windowsstoragecom.h)

Creates a handle to a file that is in a storage folder.

Syntax

HRESULT Create(
  [in]           LPCWSTR                 fileName,
  [in]           HANDLE_CREATION_OPTIONS creationOptions,
  [in]           HANDLE_ACCESS_OPTIONS   accessOptions,
  [in]           HANDLE_SHARING_OPTIONS  sharingOptions,
  [in]           HANDLE_OPTIONS          options,
  [in, optional] IOplockBreakingHandler  *oplockBreakingHandler,
  [out, retval]  HANDLE                  *interopHandle
);

Parameters

[in] fileName

The name of the file that you want to get a handle to.

[in] creationOptions

The action to take on a file that exists or doesn't exist.

[in] accessOptions

The level of access that a handle has on the file.

[in] sharingOptions

The requested sharing mode of the handle.

[in] options

The flags of the file handle.

[in, optional] oplockBreakingHandler

Not currently implemented.

[out, retval] interopHandle

The handle to the file.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirements

Requirement	Value
Minimum supported client	Windows 10 [desktop apps only]
Minimum supported server	Windows Server 2016 [desktop apps only]
Target Platform	Windows
Header	windowsstoragecom.h
DLL	Windows.storage.dll

See also

IStorageFolderHandleAccess