IStorageItemHandleAccess::Create method (windowsstoragecom.h)

Creates a handle to a file.

Syntax

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

Parameters

[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

IStorageItemHandleAccess