DkmFileTransferStream.WriteFirst(Byte[], UInt64, UInt64, Boolean) Method

Definition

Namespace:

Microsoft.VisualStudio.Debugger.DefaultPort

Assembly:

Microsoft.VisualStudio.Debugger.Engine.dll

Begins a remote file write operation. The remote file will be opened and the bytes from Content will be written to it. If additional bytes beyond what is in Content should be transferred, then WriteNext should be called to transfer those. If the directory of this file does not exist, the debugger will attempt to create it.

public:
 void WriteFirst(cli::array <System::Byte> ^ Content, System::UInt64 TotalFileSize, System::UInt64 LastWriteTime, bool OverwriteExisting);

public:
 void WriteFirst(Platform::Array <byte> ^ Content, unsigned long long TotalFileSize, unsigned long long LastWriteTime, bool OverwriteExisting);

void WriteFirst(std::Array <byte> const & Content, unsigned long TotalFileSize, unsigned long LastWriteTime, bool OverwriteExisting);

public void WriteFirst (byte[] Content, ulong TotalFileSize, ulong LastWriteTime, bool OverwriteExisting);

member this.WriteFirst : byte[] * uint64 * uint64 * bool -> unit

Public Sub WriteFirst (Content As Byte(), TotalFileSize As ULong, LastWriteTime As ULong, OverwriteExisting As Boolean)

Parameters

Content

Byte[]

[In] The initial set of bytes to write to the file.

TotalFileSize

UInt64

[In] Indicates the number of bytes which will be written to the file. The file system handle will automatically be closed once this number of bytes has been received. Attempts to write past this number of bytes will fail. If the DkmFileTransferStream is closed before this number of bytes is transferred, the file will be deleted.

LastWriteTime

UInt64

[In] The date/time to set for when this file was last modified. The format of this is the same as a Win32 FILETIME structure, which is a 64-bit value representing the number of 100-nanosecond intervals since January 1, 1601. The value 0xffffffffffffffff may be used to specify that the current time should be used.

OverwriteExisting

Boolean

[In] true if the debugger should attempt to overwrite any existing file. This will fail if the existing file is read-only.