Class KnownFolderDataBlock

The KnownFolderDataBlock structure specifies the location of a known folder. This data can be used when a link target is a known folder to keep track of the folder so that the link target IDList can be translated when the link is loaded.

Inheritance

object

Structure

ExtraDataBlock

KnownFolderDataBlock

Inherited Members

ExtraDataBlock.ValidateHeaderBlockSignature(ref byte[])

ExtraDataBlock.Validate(ref byte[], bool)

Structure.Errors

Structure.ValidateInputDataSize(int)

Structure.ValidateHeaderBlockSize(ref byte[], bool)

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

Namespace: SharpShellLink.Structures

Assembly: SharpShellLink.dll

Syntax

public class KnownFolderDataBlock : ExtraDataBlock

Constructors

KnownFolderDataBlock()

Constructor

Declaration

public KnownFolderDataBlock()

KnownFolderDataBlock(Guid, uint)

Constructor

Declaration

public KnownFolderDataBlock(Guid KnownFolderID, uint Offset)

Parameters

Type	Name	Description
Guid	KnownFolderID	A value in GUID packet representation that specifies the folder GUID ID
uint	Offset	A 32-bit, unsigned integer that specifies the location of the ItemID of the first child segment of the IDList specified by KnownFolderID

Properties

BlockSignature

BlockSignature (4 bytes): A 32-bit, unsigned integer that specifies the signature of the KnownFolderDataBlock extra data section. This value MUST be 0xA000000B.

Declaration

public override BlockSignature BlockSignature { get; }

Property Value

Type	Description
BlockSignature

Overrides

ExtraDataBlock.BlockSignature

BlockSize

BlockSize (4 bytes): A 32-bit, unsigned integer that specifies the size of the KnownFolderDataBlock structure. This value MUST be 0x0000001C.

Declaration

public override uint BlockSize { get; }

Property Value

Type	Description
uint

Overrides

ExtraDataBlock.BlockSize

KnownFolderID

KnownFolderID (16 bytes): A value in GUID packet representation that specifies the folder GUID ID.

Declaration

public Guid KnownFolderID { get; set; }

Property Value

Type	Description
Guid

MinimumBlockSize

MinimumBlockSize (4 bytes): A 32-bit, unsigned integer that specifies the minimum size of the KnownFolderDataBlock structure. This value MUST be 0x0000001C

Declaration

public override uint MinimumBlockSize { get; }

Property Value

Type	Description
uint

Overrides

Structure.MinimumBlockSize

Offset

Offset (4 bytes): A 32-bit, unsigned integer that specifies the location of the ItemID of the first child segment of the IDList specified by KnownFolderID. This value is the offset, in bytes, into the link target IDList.

Declaration

public uint Offset { get; set; }

Property Value

Type	Description
uint

Methods

FromByteArray(byte[])

Create a KnownFolderDataBlock from a given byte array

Declaration

public static KnownFolderDataBlock FromByteArray(byte[] ba)

Parameters

Type	Name	Description
byte[]	ba	The byte array

Returns

Type	Description
KnownFolderDataBlock	A KnownFolderDataBlock object

GetBytes()

Convert the Structure to a byte array

Declaration

public override byte[] GetBytes()

Returns

Type	Description
byte[]	Byte array representation of the Structure

Overrides

Structure.GetBytes()

ToString()

Returns a string that represents the current object.

Declaration

public override string ToString()

Returns

Type	Description
string	A string that represents the current object.

Overrides

ExtraDataBlock.ToString()