BP_OpenPartition (Windows CE 5.0)

Send Feedback

This function opens or creates a partition.

HANDLE BP_OpenPartition(DWORD dwStartSector, DWORD dwNumSectors,DWORD dwPartType,BOOL fActive,DWORD dwCreationFlags);

Parameters

• dwStartSector
  [in] Logical sector to the start of the partition. This value should be set to NEXT_FREE_LOC if no sector is specified. This parameter is ignored if an existing partition is opened.
• dwNumSectors
  [in] Number of logical sectors of the partition. This value can be set to USE_REMAINING_SPACE to indicate that the remaining space on the flash for the partition should be used. The USE_REMAINING_SPACE value should only be used when creating an extended partition. This parameter is ignored if an existing partition is opened.
• dwPartType
  [in] Type of partition to open or create. The following table shows the possible values for dwPartType.

  Value	Description
  PART_BOOTSECTION	Creates a boot section that can be used to store boot arguments. All flash blocks in the partition are marked as read-only.
  PART_BINFS	Creates a BinFS partition. All flash blocks in the partition are marked as read-only.
  PART_EXTENDED	Creates an extended partition that can be used to store one or more data partitions, such as FATFS. If dwStartSector is not on a block boundary then it is incremented to start at the next block boundary.

• fActive
  [in] Set to TRUE to indicate that the partition is active. Set to FALSE for inactive.
• dwCreationFlags
  [in] Value that stores information for opening or creating a partition. The following table shows the possible values for dwCreationFlags.

  Value	Description
  PART_CREATE_NEW	Creates a partition. Fails if a partition already exists.
  PART_OPEN_EXISTING	Opens an existing partition. Fails if the partition does not exist.
  PART_OPEN_ALWAYS	Creates a partition if it does not exist or opens a partition if it does exist.

Return Values

Returns a handle to the partition on success. Returns INVALID_HANDLE_VALUE on an error.

Requirements

OS Versions: Windows CE .NET 4.2 and later.
Header: Bootpart.h
Link Library: Bootpart.lib

See Also

BinFS and the Bootpart Library | Flash Media Drivers

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.