184.108.40.206 Displaying Information about an Address Book Object
When a client or user agent wants to view or change the information contained in an address book entry, the client MUST retrieve the display template for the address book entry's display type and display the data to the user. To retrieve the display dialog template that is used to display information about a particular Address Book object, the NspiGetTemplateInfo function, as specified in [MS-NSPI] and [MS-OXNSPI] section 220.127.116.11.18, MUST be called with the ulType parameter set to the display type of the object and the pDN parameter set to 0x00000000. The dwFlags parameter contains a bitwise combination that MUST include the bit for the TI_TEMPLATE (0x00000001) flag set so the template will be retrieved and MAY contain the bits for the TI_HELPFILE_NAME (0x00000020) and TI_HELPFILE (0x00000040) flags for a value of 0x00000061.<5> The dwLocaleID parameter contains the LCID value, as specified in [MS-LCID], of the template. The function's dwCodePage input parameter is the code page in which the strings in the template are stored and the ppData return parameter contains a pointer to a PropertyRow_r structure, as specified in [MS-NSPI] and [MS-OXNSPI] section 2.2.3, that contains the data needed to create and display the dialog. Data to initialize the dialog MUST be retrieved from the Address Book object by using the properties specified for each control in the dialog in the PidTagTemplateData ([MS-OXPROPS] section 2.1032) property of the PropertyRow_r structure. If the dialog is updated, the data from the dialog MUST be used to update the properties that are associated with the controls and these properties MUST be updated on the Address Book object by using the NspiModProps and NspiModLinkAtt functions, depending on the property type. The NspiModLinkAtt function is used to update the distribution list membership, and NspiModProps is used to update the other properties. Only the changed properties SHOULD be sent to the server. The NspiModProps function is specified in [MS-NSPI] and [MS-OXNSPI] section 18.104.22.168.14. The NspiModLinkAtt function is specified in [MS-NSPI] and [MS-OXNSPI] section 22.214.171.124.