2.2.1 NspiGetSpecialTable PropertyRowSet_r Format

The dwFlags parameter that is passed to the NspiGetSpecialTable function, as specified in [MS-NSPI] and [MS-OXNSPI] section, affects the data that is returned in the PropertyRowSet_r output parameter. The bit flag values for the dwFlags parameter for this function are specified in [MS-OXNSPI] section The client MUST pass the NspiAddressCreationTemplates flag to retrieve the table of supported address types from the server and MUST NOT pass any of the other flags. The properties listed in the following table MUST be returned by the server in the PropertyRow_r structure, as specified in [MS-NSPI] and [MS-OXNSPI] section 2.2.3, that is contained in the PropertyRowSet_r return parameter of the call.

Property name


PidTagAddressType ([MS-OXPROPS] section 2.567)

STRING property that indicates the type of address that is associated with the new recipient created with the template.

PidTagDisplayName ([MS-OXPROPS] section 2.667)

STRING property that contains a user-readable identification of the address type.

PidTagDisplayType([MS-OXPROPS] section 2.670)

A LONG property that contains a constant that identifies the type of Address Book object that the new recipient will be and therefore what icon the client will display for it. The values are specified in [MS-OXOABK] section

PidTagEntryId [MS-OXPROPS] section 2.674)

A BINARY property that contains the entry ID of the template to be used to create the new recipient. This identifier can be parsed to get the distinguished name (DN) (2) to be passed to NspiGetTemplateInfo function, as specified in [MS-NSPI] and [MS-OXNSPI] section to retrieve the template. For details about the format of permanent entry IDs, see [MS-NSPI] and [MS-OXNSPI] section

PidTagDepth ([MS-OXPROPS] section 2.664)

A LONG property that MUST be ignored.

PidTagSelectable ([MS-OXPROPS] section 2.990)

A BOOLEAN property that MUST be ignored.

PidTagInstanceKey ([MS-OXPROPS] section 2.734)

A BINARY property that contains a unique binary value.