IStorageFile2.OpenTransactedWriteAsync(StorageOpenOptions) メソッド

定義

名前空間:

Windows.Storage

指定したオプションを使用して、トランザクション書き込み操作に使用できるファイルへのランダム アクセス ストリームを開きます。

public:
 IAsyncOperation<StorageStreamTransaction ^> ^ OpenTransactedWriteAsync(StorageOpenOptions options);

/// [Windows.Foundation.Metadata.Overload("OpenTransactedWriteWithOptionsAsync")]
/// [Windows.Foundation.Metadata.RemoteAsync]
IAsyncOperation<StorageStreamTransaction> OpenTransactedWriteAsync(StorageOpenOptions const& options);

[Windows.Foundation.Metadata.Overload("OpenTransactedWriteWithOptionsAsync")]
[Windows.Foundation.Metadata.RemoteAsync]
public IAsyncOperation<StorageStreamTransaction> OpenTransactedWriteAsync(StorageOpenOptions options);

function openTransactedWriteAsync(options)

Public Function OpenTransactedWriteAsync (options As StorageOpenOptions) As IAsyncOperation(Of StorageStreamTransaction)

パラメーター

options

StorageOpenOptions

ストリームを開くオプションを指定する列挙値のビットごとの組み合わせ。

戻り値

IAsyncOperation<StorageStreamTransaction>

このメソッドが完了すると、トランザクションの完了に使用できるランダム アクセス ストリームとメソッドを含む StorageStreamTransaction が返されます。

属性

OverloadAttribute RemoteAsyncAttribute

注釈

このメソッドは、一時ファイルに書き込むストリームを作成し、その後、一時ファイルの名前を実際のファイルに変更して、実際のファイルに書き込みをアトミックにコミットします。 ストリーム書き込みのしくみにより、トランザクション ライターは別のライターと共存できません。つまり、StorageOpenOptions.AllowReadersAndWriters はこのメソッドに対して有効ではなく、使用した場合はE_INVALIDARGを返します。