2.2.2.1.3 Buffer Format of the CNTRL Structure

The base CNTRL structure is defined as follows, with each entry taking a different meaning, depending on the type of control, as shown in the following table.

Field name

Type

Size

Description

dwType

DWORD

4

Varies depending on the control. For details, see sections 2.2.2.1.3.1 through 2.2.2.1.3.9.

ulSize

ULONG

4

Varies depending on the control. For details, see sections 2.2.2.1.3.1 through 2.2.2.1.3.9.

ulString

ULONG

4

The offset in BYTEs from the base of the TRowSet structure to a null-terminated non-Unicode string. This string MUST be in the code page indicated by dwCodePage  parameter of the NspiGetTemplateInfo function call, as specified in [MS-NSPI] and [MS-OXNSPI] section 3.1.4.1.18, and MUST be terminated by a NULL character. In these strings, the "&" (ampersand) has special meaning and indicates that the character that immediately follows it MUST be used as a shortcut key to select this control. If the control cannot be selected, the control that follows it is selected. If an "&" needs to be in the string and it SHOULD NOT have any special meaning, a sequence of "&&" can be used to indicate this.

For more details about string values, usage and limitations, see sections 2.2.2.1.3.1 through 2.2.2.1.3.9.