Share via

SMTP Categorizer Sink

  • Article

 

SMTP Categorizer Sink

The CatReader sink example demonstrates how to implement a categorizer event sink for the SMTP service. CatReader looks up an attribute requested by a client, and requests that the categorizer search for the value in the directory service (DS). The value returned from the DS search is then saved on the mailmsg object.

The following is the format in which the client must add attributes to the registry. Customers who use this sink must create and associate a new GUID for each required attribute. Both the GUID and attribute names are of the REG_SZ type.

   [HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Exchange\CatReader]       "officeLocation"="{8C515674-E27B-4924-95BD-7CB0FB24D9B1}"       "sAMAccountType"="{AC515674-E27B-4924-95BD-7CB0FB24D9B2}"

Note   The attributes must be valid and must be replicated to the Global Catalog (GC) so they can be read by the Exchange Server machine account.

Important   Microsoft® Exchange 2000 Server developers who write Categorizer sinks to look up attributes must execute the following workaround to ensure that the categorizer interface used to retrieve the raw attribute values will work.

  • Using a metabase utility, set the SMTP Service metabase DS Configuration Key, smtpsvc/DSFlags, to 0x1000F.

The following topics contain the code for the CatReader sink example.