开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > 游戏 > 模拟服务器 > 查看源码
SmtpEvent.Idl
资源名称：SwordOnline.rar　[点击查看]
上传用户：dzyhzl
上传日期：2019-04-29
资源大小：56270k
文件大小：61k
源码类别：

模拟服务器

开发平台：

C/C++

SmtpEvent.Idl：源码内容
  1. //+------------------------------------------------------------
  2. //
  3. // Copyright (C) 1999, Microsoft Corporation
  4. //
  5. // File: smtpevent.idl
  6. //
  7. // Contents: SMTP Server Event interfaces
  8. //
  9. // Description: This file contains the interface definitions for the
  10. //              SMTP Server Events.
  11. //
  12. //-------------------------------------------------------------
  14. cpp_quote("#ifndef __SMTPEVENT_H__")
  15. cpp_quote("#define __SMTPEVENT_H__")
  17. import "unknwn.idl";
  18. import "wtypes.idl";
  19. import "ocidl.idl";
  20. import "mailmsg.idl";
  22. //+------------------------------------------------------------
  23. //
  24. // The SMTP Protocol events interfaces:
  25. //
  26. //-------------------------------------------------------------
  27. cpp_quote("//")
  28. cpp_quote("// Define sink return codes")
  29. cpp_quote("//")
  31. cpp_quote("#define EXPE_S_CONSUMED              0x00000002")
  33. cpp_quote("//")
  34. cpp_quote("// Define well-known status codes")
  35. cpp_quote("//")
  37. cpp_quote("#define EXPE_SUCCESS                 0x00000000")
  38. cpp_quote("#define EXPE_NOT_PIPELINED           0x00000000")
  39. cpp_quote("#define EXPE_PIPELINED               0x00000001")
  40. cpp_quote("#define EXPE_REPEAT_COMMAND          0x00000002")
  41. cpp_quote("#define EXPE_BLOB_READY              0x00000004")
  42. cpp_quote("#define EXPE_BLOB_DONE               0x00000008")
  44. cpp_quote("#define EXPE_DROP_SESSION            0x00010000")
  45. cpp_quote("#define EXPE_CHANGE_STATE            0x00020000")
  46. cpp_quote("#define EXPE_TRANSIENT_FAILURE       0x00040000")
  47. cpp_quote("#define EXPE_COMPLETE_FAILURE        0x00080000")
  49. cpp_quote("#define EXPE_UNHANDLED                       0xffffffff")
  51. cpp_quote("//")
  52. cpp_quote("// Define constants for next states")
  53. cpp_quote("//")
  55. cpp_quote("typedef enum _PE_STATES")
  56. cpp_quote("{")
  57. cpp_quote("     PE_STATE_DEFAULT = 0,")
  58. cpp_quote("     PE_STATE_SESSION_START,")
  59. cpp_quote("     PE_STATE_MESSAGE_START,")
  60. cpp_quote("     PE_STATE_PER_RECIPIENT,")
  61. cpp_quote("     PE_STATE_DATA_OR_BDAT,")
  62. cpp_quote("     PE_STATE_SESSION_END,")
  63. cpp_quote("     PE_STATE_MAX_STATES = PE_STATE_SESSION_END")
  64. cpp_quote("")
  65. cpp_quote("} PE_STATES;")
  68. cpp_quote("//")
  69. cpp_quote("// Define macros for checking SMTP return code classes")
  70. cpp_quote("//")
  72. cpp_quote("#define IsSmtpPreliminarySuccess(x)          ((((x) % 100) == 1)?TRUE:FALSE)")
  73. cpp_quote("#define IsSmtpCompleteSuccess(x)                     ((((x) % 100) == 2)?TRUE:FALSE)")
  74. cpp_quote("#define IsSmtpIntermediateSuccess(x)         ((((x) % 100) == 3)?TRUE:FALSE)")
  75. cpp_quote("#define IsSmtpTransientFailure(x)            ((((x) % 100) == 4)?TRUE:FALSE)")
  76. cpp_quote("#define IsSmtpCompleteFailure(x)                     ((((x) % 100) == 5)?TRUE:FALSE)")
  78. cpp_quote("//")
  79. cpp_quote("// Define well known IServer property IDs")
  80. cpp_quote("//")
  81. cpp_quote("#define PE_ISERVID_DW_INSTANCE               0")
  82. cpp_quote("#define PE_ISERVID_SZ_DEFAULTDOMAIN          1")
  83. cpp_quote("#define PE_ISERVID_DW_CATENABLE              2")
  84. cpp_quote("#define PE_ISERVID_DW_CATFLAGS               3")
  85. cpp_quote("#define PE_ISERVID_DW_CATPORT                4")
  86. cpp_quote("#define PE_ISERVID_SZ_CATUSER                5")
  87. cpp_quote("#define PE_ISERVID_SZ_CATSCHEMA              6")
  88. cpp_quote("#define PE_ISERVID_SZ_CATBINDTYPE            7")
  89. cpp_quote("#define PE_ISERVID_SZ_CATPASSWORD            8")
  90. cpp_quote("#define PE_ISERVID_SZ_CATDOMAIN              9")
  91. cpp_quote("#define PE_ISERVID_SZ_CATNAMINGCONTEXT      10")
  92. cpp_quote("#define PE_ISERVID_SZ_CATDSTYPE             11")
  93. cpp_quote("#define PE_ISERVID_SZ_CATDSHOST             12")
  95. cpp_quote("//")
  96. cpp_quote("// Define well known ISession property IDs")
  97. cpp_quote("//")
  98. cpp_quote("#define ISESSION_PID_IS_SESSION_AUTHENTICATED 0")
  99. cpp_quote("#define ISESSION_PID_AUTHENTICATED_USERNAME   1")
  100. cpp_quote("#define ISESSION_PID_REMOTE_SERVER_NAME       2")
  102. interface ISmtpInCallbackSink;
  104. [
  105.                 object,
  106.                 local,
  107.                 uuid(5F15C533-E90E-11D1-8852-00C04FA35B86),
  108.                 helpstring("ISmtpInCommandContext Interface"),
  109.                 pointer_default(unique)
  110. ]
  111. interface ISmtpInCommandContext : IUnknown
  112. {
  113.         // Query methods
  114.         HRESULT QueryCommand(
  115.                                 [out,size_is(*pdwSize)] LPSTR   pszCommand,
  116.                                 [in,out]                                DWORD   *pdwSize
  117.                                 );
  119.         HRESULT QueryCommandKeyword(
  120.                                 [out,size_is(*pdwSize)] LPSTR   pszKeyword,
  121.                                 [in,out]                                DWORD   *pdwSize
  122.                                 );
  124.         HRESULT QueryNativeResponse(
  125.                                 [out,size_is(*pdwSize)] LPSTR   pszNativeResponse,
  126.                                 [in,out]                                DWORD   *pdwSize
  127.                                 );
  129.         HRESULT QueryResponse(
  130.                                 [out,size_is(*pdwSize)] LPSTR   pszResponse,
  131.                                 [in,out]                                DWORD   *pdwSize
  132.                                 );
  134.         HRESULT QueryCommandSize(
  135.                                 [out] DWORD     *pdwSize
  136.                                 );
  138.         HRESULT QueryCommandKeywordSize(
  139.                                 [out] DWORD     *pdwSize
  140.                                 );
  142.         HRESULT QueryNativeResponseSize(
  143.                                 [out] DWORD     *pdwSize
  144.                                 );
  146.         HRESULT QueryResponseSize(
  147.                                 [out] DWORD     *pdwSize
  148.                                 );
  150.         HRESULT QueryCommandStatus(
  151.                                 [out] DWORD     *pdwCommandStatus
  152.                                 );
  154.         HRESULT QuerySmtpStatusCode(
  155.                                 [out] DWORD     *pdwSmtpStatus
  156.                                 );
  158.         HRESULT QueryProtocolErrorFlag(
  159.                                 [out] BOOL      *pfProtocolError
  160.                                 );
  162.         // Set methods
  163.         HRESULT SetResponse(
  164.                                 [in,string] LPSTR       pszResponse,
  165.                                 [in]            DWORD   dwSize
  166.                                 );
  168.         HRESULT AppendResponse(
  169.                                 [in,string] LPSTR       pszResponse,
  170.                                 [in]            DWORD   dwSize
  171.                                 );
  173.         HRESULT SetNativeResponse(
  174.                                 [in,string] LPSTR       pszNativeResponse,
  175.                                 [in]            DWORD   dwSize
  176.                                 );
  178.         HRESULT AppendNativeResponse(
  179.                                 [in,string] LPSTR       pszNativeResponse,
  180.                                 [in]            DWORD   dwSize
  181.                                 );
  183.         HRESULT SetCommandStatus(
  184.                                 [in] DWORD      dwCommandStatus
  185.                                 );
  187.         HRESULT SetSmtpStatusCode(
  188.                                 [in] DWORD      dwSmtpStatus
  189.                                 );
  191.         HRESULT SetProtocolErrorFlag(
  192.                                 [in] BOOL       fProtocolError
  193.                                 );
  195.         // Async completion callback
  196.         HRESULT NotifyAsyncCompletion(
  197.                                 [in] HRESULT    hrResult
  198.                                 );
  200.         HRESULT SetCallback(
  201.                                 [in] ISmtpInCallbackSink * pICallback
  202.                                 );
  203. };
  205. [
  206.                 object,
  207.                 local,
  208.                 uuid(5e4fc9da-3e3b-11d3-88f1-00c04fa35b86),
  209.                 helpstring("ISmtpInCallbackContext Interface"),
  210.                 pointer_default(unique)
  211. ]
  212. interface ISmtpInCallbackContext : IUnknown
  213. {
  214.         // Query methods
  215.         HRESULT QueryBlob(
  216.                                 [out]           BYTE    **ppbBlob,
  217.                                 [in,out]        DWORD   *pdwSize
  218.                                 );
  220.         HRESULT QueryBlobSize(
  221.                                 [out] DWORD     *pdwSize
  222.                                 );
  224.         // Set methods
  225.         HRESULT SetResponse(
  226.                                 [in,string] LPSTR       pszResponse,
  227.                                 [in]            DWORD   dwSize
  228.                                 );
  230.         HRESULT AppendResponse(
  231.                                 [in,string] LPSTR       pszResponse,
  232.                                 [in]            DWORD   dwSize
  233.                                 );
  235.         HRESULT SetCommandStatus(
  236.                                 [in] DWORD      dwCommandStatus
  237.                                 );
  239.         HRESULT SetSmtpStatusCode(
  240.                                 [in] DWORD      dwSmtpStatus
  241.                                 );
  242. };
  244. [
  245.                 object,
  246.                 local,
  247.                 uuid(c849b5f2-0a80-11d2-aa67-00c04fa35b82),
  248.                 helpstring("ISmtpOutCommandContext Interface"),
  249.                 pointer_default(unique)
  250. ]
  251. interface ISmtpOutCommandContext : IUnknown
  252. {
  253.         // Query methods
  254.         HRESULT QueryCommand(
  255.                                 [out,size_is(*pdwSize)] LPSTR   pszCommand,
  256.                                 [in,out]                                DWORD   *pdwSize
  257.                                 );
  259.         HRESULT QueryCommandKeyword(
  260.                                 [out,size_is(*pdwSize)] LPSTR   pszKeyword,
  261.                                 [in,out]                                DWORD   *pdwSize
  262.                                 );
  264.         HRESULT QueryNativeCommand(
  265.                                 [out,size_is(*pdwSize)] LPSTR   pszNativeCommand,
  266.                                 [in,out]                                DWORD   *pdwSize
  267.                                 );
  269.         HRESULT QueryCommandSize(
  270.                                 [out] DWORD     *pdwSize
  271.                                 );
  273.         HRESULT QueryCommandKeywordSize(
  274.                                 [out] DWORD     *pdwSize
  275.                                 );
  277.         HRESULT QueryNativeCommandSize(
  278.                                 [out] DWORD     *pdwSize
  279.                                 );
  281.         HRESULT QueryCurrentRecipientIndex(
  282.                                 [out] DWORD     *pdwRecipientIndex
  283.                                 );
  285.         HRESULT QueryCommandStatus(
  286.                                 [out] DWORD     *pdwCommandStatus
  287.                                 );
  289.         // Set methods
  290.         HRESULT SetCommand(
  291.                                 [in,string] LPSTR       szCommand,
  292.                                 [in]            DWORD   dwSize
  293.                                 );
  295.         HRESULT AppendCommand(
  296.                                 [in,string] LPSTR       szCommand,
  297.                                 [in]            DWORD   dwSize
  298.                                 );
  300.         HRESULT SetCommandStatus(
  301.                                 [in] DWORD      dwCommandStatus
  302.                                 );
  304.         // Async completion callback
  305.         HRESULT NotifyAsyncCompletion(
  306.                                 [in] HRESULT    hrResult
  307.                                 );
  309.         HRESULT SetBlob(
  310.                                 [in]            BYTE    *pbBlob,
  311.                                 [in]            DWORD   dwSize
  312.                                 );
  314. };
  316. [
  317.                 object,
  318.                 local,
  319.                 uuid(e38f9ad2-0a82-11d2-aa67-00c04fa35b82),
  320.                 helpstring("ISmtpServerResponseContext Interface"),
  321.                 pointer_default(unique)
  322. ]
  323. interface ISmtpServerResponseContext : IUnknown
  324. {
  325.         // Query methods
  326.         HRESULT QueryCommand(
  327.                                 [out,size_is(*pdwSize)] LPSTR   pszCommand,
  328.                                 [in,out]                                DWORD   *pdwSize
  329.                                 );
  331.         HRESULT QueryCommandKeyword(
  332.                                 [out,size_is(*pdwSize)] LPSTR   pszKeyword,
  333.                                 [in,out]                                DWORD   *pdwSize
  334.                                 );
  336.         HRESULT QueryResponse(
  337.                                 [out,size_is(*pdwSize)] LPSTR   pszResponse,
  338.                                 [in,out]                                DWORD   *pdwSize
  339.                                 );
  341.         HRESULT QueryCommandSize(
  342.                                 [out] DWORD     *pdwSize
  343.                                 );
  345.         HRESULT QueryCommandKeywordSize(
  346.                                 [out] DWORD     *pdwSize
  347.                                 );
  349.         HRESULT QueryResponseSize(
  350.                                 [out] DWORD     *pdwSize
  351.                                 );
  353.         HRESULT QuerySmtpStatusCode(
  354.                                 [out] DWORD     *pdwSmtpStatus
  355.                                 );
  357.         HRESULT QueryResponseStatus(
  358.                                 [out] DWORD     *pdwResponseStatus
  359.                                 );
  361.         HRESULT QueryPipelinedFlag(
  362.                                 [out] BOOL      *pfResponseIsPipelined
  363.                                 );
  365.         HRESULT QueryNextEventState(
  366.                                 [out] DWORD     *pdwNextState
  367.                                 );
  369.         // Set methods
  370.         HRESULT SetResponseStatus(
  371.                                 [in] DWORD      dwResponseStatus
  372.                                 );
  374.         HRESULT SetNextEventState(
  375.                                 [in] DWORD      dwNextState
  376.                                 );
  378.         // Async completion callback
  379.         HRESULT NotifyAsyncCompletion(
  380.                                 [in] HRESULT    hrResult
  381.                                 );
  383. };
  386. // =============================================================
  387. //
  388. // Inbound Protocol Event Sink Shape
  389. //
  390. [
  391.         object,
  392.         uuid(b2d42a0e-0d5f-11d2-aa68-00c04fa35b82),
  393.         helpstring("ISmtpInCommandSink Interface"),
  394.         pointer_default(unique)
  395. ]
  396. interface ISmtpInCommandSink : IUnknown
  397. {
  398.         [helpstring("OnSmtpInCommand method")]
  399.         HRESULT OnSmtpInCommand(
  400.                                 [in] IUnknown                           *pServer,
  401.                                 [in] IUnknown                           *pSession,
  402.                                 [in] IMailMsgProperties         *pMsg,
  403.                                 [in] ISmtpInCommandContext      *pContext
  404.                                 );
  405. };
  408. // =============================================================
  409. //
  410. // Outbound Command Generation Protocol Event Sink Shape
  411. //
  412. [
  413.         object,
  414.         uuid(cfdbb9b0-0ca0-11d2-aa68-00c04fa35b82),
  415.         helpstring("ISmtpOutCommandSink Interface"),
  416.         pointer_default(unique)
  417. ]
  418. interface ISmtpOutCommandSink : IUnknown
  419. {
  420.         [helpstring("OnSmtpOutCommand method")]
  421.         HRESULT OnSmtpOutCommand(
  422.                                 [in] IUnknown                           *pServer,
  423.                                 [in] IUnknown                           *pSession,
  424.                                 [in] IMailMsgProperties         *pMsg,
  425.                                 [in] ISmtpOutCommandContext *pContext
  426.                                 );
  427. };
  430. // =============================================================
  431. //
  432. // Server Response Protocol Event Sink Shape
  433. //
  434. [
  435.         object,
  436.         uuid(d7e10222-0ca1-11d2-aa68-00c04fa35b82),
  437.         helpstring("ISmtpServerResponseSink Interface"),
  438.         pointer_default(unique)
  439. ]
  440. interface ISmtpServerResponseSink : IUnknown
  441. {
  442.         [helpstring("OnSmtpServerResponse method")]
  443.         HRESULT OnSmtpServerResponse(
  444.                                 [in] IUnknown                                   *pServer,
  445.                                 [in] IUnknown                                   *pSession,
  446.                                 [in] IMailMsgProperties                 *pMsg,
  447.                                 [in] ISmtpServerResponseContext *pContext
  448.                                 );
  449. };
  452. // =============================================================
  453. //
  454. // Inbound Protocol Event Callback Sink Shape
  455. //
  456. [
  457.         object,
  458.         uuid(0012b624-3e3c-11d3-88f1-00c04fa35b86),
  459.         helpstring("ISmtpInCallbackSink Interface"),
  460.         pointer_default(unique)
  461. ]
  462. interface ISmtpInCallbackSink : IUnknown
  463. {
  464.         [helpstring("OnSmtpInCallback method")]
  465.         HRESULT OnSmtpInCallback(
  466.                                 [in] IUnknown                           *pServer,
  467.                                 [in] IUnknown                           *pSession,
  468.                                 [in] IMailMsgProperties         *pMsg,
  469.                                 [in] ISmtpInCallbackContext     *pContext
  470.                                 );
  471. };
  474. //+------------------------------------------------------------
  475. //
  476. // The SMTP Mail Transport interfaces:
  477. //
  478. //-------------------------------------------------------------
  480. //
  481. // The default processing priority of the transport events:
  482. //
  483. cpp_quote("#define SMTP_TRANSPORT_DEFAULT_PRIORITY 16384")
  486. //+------------------------------------------------------------
  487. //
  488. // Interface: IMailTransportNotify
  489. //
  490. // Synopsis: Used for async events
  491. //
  492. //
  493. //-------------------------------------------------------------
  494. [
  495.     object,
  496.     uuid(6E1CAA77-FCD4-11d1-9DF9-00C04FA322BA),
  497.     helpstring("IMailTransportNotify Interface"),
  498.     pointer_default(unique)
  499. ]
  500. interface IMailTransportNotify : IUnknown
  501. {
  502.     [local]
  503.     HRESULT Notify(
  504.         [in] HRESULT hrCompletion,
  505.         [in] PVOID pvContext);
  506. };
  508. //+------------------------------------------------------------
  509. //
  510. // Interface: IMailTransportSubmission
  511. //
  512. // Synopsis: Used for the SMTP_MAILTRANSPORT_ONMESSAGESUBMISSION event
  513. //
  514. //
  515. //-------------------------------------------------------------
  516. [
  517.     object,
  518.     uuid(CE681916-FF14-11d1-9DFB-00C04FA322BA),
  519.     helpstring("IMailTransportSubmission Interface"),
  520.     pointer_default(unique)
  521. ]
  522. interface IMailTransportSubmission : IUnknown
  523. {
  524.     [local]
  525.     HRESULT OnMessageSubmission(
  526.         [in] IMailMsgProperties     *pIMailMsg,
  527.         [in] IMailTransportNotify   *pINotify,
  528.         [in] PVOID                   pvNotifyContext);
  529. };
  531. //+------------------------------------------------------------
  532. //
  533. // Interface: IMailTransportOnPreCategorize
  534. //
  535. // Synopsis: Used for the SMTP_MAILTRANSPORT_PRECATEGORIZE event
  536. //
  537. //
  538. //-------------------------------------------------------------
  539. [
  540.     object,
  541.     uuid(A3ACFB0E-83FF-11d2-9E14-00C04FA322BA),
  542.     helpstring("IMailTransportOnPreCategorize Interface"),
  543.     pointer_default(unique)
  544. ]
  545. interface IMailTransportOnPreCategorize : IUnknown
  546. {
  547.     [local]
  548.     HRESULT OnSyncMessagePreCategorize(
  549.         [in] IMailMsgProperties     *pIMailMsg,
  550.         [in] IMailTransportNotify   *pINotify,
  551.         [in] PVOID                   pvNotifyContext);
  552. };
  555. //+------------------------------------------------------------
  556. //
  557. // Interface: IMailTransportOnPostCategorize
  558. //
  559. // Synopsis: Used for the SMTP_MAILTRANSPORT_POSTCATEGORIZE event
  560. //
  561. //
  562. //-------------------------------------------------------------
  563. [
  564.     object,
  565.     uuid(76719653-05A6-11d2-9DFD-00C04FA322BA),
  566.     helpstring("IMailTransportOnPostCategorize Interface"),
  567.     pointer_default(unique)
  568. ]
  569. interface IMailTransportOnPostCategorize : IUnknown
  570. {
  571.     [local]
  572.     HRESULT OnMessagePostCategorize(
  573.         [in] IMailMsgProperties     *pIMailMsg,
  574.         [in] IMailTransportNotify   *pINotify,
  575.         [in] PVOID                   pvNotifyContext);
  576. };
  578. cpp_quote("#define RESET_NEXT_HOPS         0")
  579. cpp_quote("#define RESET_MESSAGE_TYPES     1")
  581. //+------------------------------------------------------------
  582. //
  583. // Interface: IMailTransportRouterReset
  584. //
  585. // Synopsis: System implemented interface for resetting routes
  586. //
  587. //
  588. //-------------------------------------------------------------
  589. [
  590.     object,
  591.     uuid(A928AD12-1610-11d2-9E02-00C04FA322BA),
  592.     helpstring("IMailTransportRouterReset Interface"),
  593.     pointer_default(unique)
  594. ]
  595. interface IMailTransportRouterReset : IUnknown
  596. {
  597.     HRESULT ResetRoutes(
  598.         [in] DWORD                   dwResetType);
  599. };
  601. //+------------------------------------------------------------
  602. //
  603. // Interface: IMailTransportSetRouterReset
  604. //
  605. // Synopsis: Used for the SMTP_MAILTRANSPORT_ON_SET_ROUTER_RESET event
  606. //
  607. //
  608. //-------------------------------------------------------------
  609. [
  610.     object,
  611.     uuid(A928AD11-1610-11d2-9E02-00C04FA322BA),
  612.     helpstring("IMailTransportSetRouterReset Interface"),
  613.     pointer_default(unique)
  614. ]
  615. interface IMailTransportSetRouterReset : IUnknown
  616. {
  617.     HRESULT RegisterResetInterface(
  618.         [in] DWORD                      dwVirtualServerID,
  619.         [in] IMailTransportRouterReset *pIRouterReset);
  620. };
  622. //+------------------------------------------------------------
  623. //
  624. // Interface: IMessageRouter
  625. //
  626. // Synopsis: Sink supplied interface
  627. //
  628. //
  629. //-------------------------------------------------------------
  630. [
  631.     object,
  632.     uuid(A928AD14-1610-11d2-9E02-00C04FA322BA),
  633.     helpstring("IMessageRouter Interface"),
  634.     pointer_default(unique)
  635. ]
  636. interface IMessageRouter : IUnknown
  637. {
  638.     [local]
  639.     GUID GetTransportSinkID();
  641.     HRESULT GetMessageType(
  642.         [in]  IMailMsgProperties        *pIMailMsg,
  643.         [out] DWORD                     *pdwMessageType);
  645.     HRESULT ReleaseMessageType(
  646.         [in]  DWORD                     dwMessageType,
  647.         [in]  DWORD                     dwReleaseCount);
  649.     [local]
  650.     HRESULT GetNextHop(
  651.         [in]  LPSTR                     pszDestinationAddressType,
  652.         [in]  LPSTR                     pszDestinationAddress,
  653.         [in]  DWORD                     dwMessageType,
  654.         [out] LPSTR                     *ppszRouteAddressType,
  655.         [out] LPSTR                     *ppszRouteAddress,
  656.         [out] DWORD                     *pdwScheduleID,
  657.         [out] LPSTR                     *ppszRouteAddressClass,
  658.         [out] LPSTR                     *ppszConnectorName,
  659.         [out] DWORD                     *pdwNextHopType);
  661.     [local]
  662.     HRESULT GetNextHopFree(
  663.         [in]  LPSTR                     pszDestinationAddressType,
  664.         [in]  LPSTR                     pszDestinationAddress,
  665.         [in]  LPSTR                     pszConnectorName,
  666.         [in]  LPSTR                     pszRouteAddressType,
  667.         [in]  LPSTR                     pszRouteAddress,
  668.         [in]  LPSTR                     pszRouteAddressClass);
  670.     HRESULT ConnectionFailed(
  671.         [in, string]  LPSTR             pszConnectorName);
  672. };
  674. //Some standard RouteAddressTypes that might be returned by GetNextHop
  675. const LPCSTR MTI_ROUTING_ADDRESS_TYPE_NULL      = NULL;
  676. const LPCSTR MTI_ROUTING_ADDRESS_TYPE_SMTP      = "SMTP";
  677. const LPCSTR MTI_ROUTING_ADDRESS_TYPE_X400      = "X400";
  678. const LPCSTR MTI_ROUTING_ADDRESS_TYPE_X500      = "X500";
  680. //---[ NEXT_HOP_TYPE ]---------------------------------------------------------
  681. //
  682. //
  683. //  Description:
  684. //      Enum for the possible next hop types
  685. //
  686. //-----------------------------------------------------------------------------
  687. typedef [v1_enum] enum {
  688.     MTI_NEXT_HOP_TYPE_SAME_VIRTUAL_SERVER,
  689.     MTI_NEXT_HOP_TYPE_PEER_SMTP1_BYPASS_CONFIG_LOOKUP,
  690.     MTI_NEXT_HOP_TYPE_EXTERNAL_SMTP,
  691.     MTI_NEXT_HOP_TYPE_UNREACHABLE,
  692.     MTI_NEXT_HOP_TYPE_CURRENTLY_UNREACHABLE,
  693.     MTI_NEXT_HOP_TYPE_PEER_SMTP2_BYPASS_CONFIG_LOOKUP
  694. } MTI_NEXT_HOP_TYPE, *PMTI_NEXT_HOP_TYPE;
  697. // #defines for old names for these values
  698. #define MTI_NEXT_HOP_TYPE_REMOTE 
  699.     (MTI_NEXT_HOP_TYPE_PEER_SMTP1_BYPASS_CONFIG_LOOKUP)
  701. #define MTI_NEXT_HOP_TYPE_RESERVED  
  702.     (MTI_NEXT_HOP_TYPE_EXTERNAL_SMTP)
  704. //+------------------------------------------------------------
  705. //
  706. // Interface: IMailTransportRouterSetLinkState
  707. //
  708. // Synopsis: System implemented interface for allowing a
  709. //  routing sink to update the link state for features such
  710. //  as:
  711. //    - Scheduled Connections
  712. //    - Scheduled Commands
  713. //
  714. //  If LINK_STATE_SCHED_ENABLED is being unset... a next
  715. //  scheduled connection time should be returned.
  716. //
  717. //
  718. //-------------------------------------------------------------
  719. [
  720.     object,
  721.     uuid(B870CE28-A755-11d2-A6A9-00C04FA3490A),
  722.     helpstring("IMailTransportRouterSetLinkState Interface"),
  723.     pointer_default(unique)
  724. ]
  725. interface IMailTransportRouterSetLinkState : IUnknown
  726. {
  727.     HRESULT SetLinkState(
  728.         [in] LPSTR                   szLinkDomainName,
  729.         [in] GUID                    guidRouterGUID,
  730.         [in] DWORD                   dwScheduleID,
  731.         [in] LPSTR                   szConnectorName,
  732.         [in] DWORD                   dwSetLinkState,
  733.         [in] DWORD                   dwUnsetLinkState,
  734.         [in] FILETIME               *pftNextScheduled,
  735.                 [in] IMessageRouter                     *pMessageRouter);
  736. };
  738. //+------------------------------------------------------------
  739. //
  740. // Interface: IMessageRouterLinkStateNotification
  741. //
  742. // Synopsis: Sink supplied interface that is used for notifying
  743. //  the routing sink of link state on connection acks.
  744. //
  745. //  If LINK_STATE_SCHED_ENABLED is being unset... a next
  746. //  scheduled connection time should be returned.
  747. //
  748. //
  749. //-------------------------------------------------------------
  750. [
  751.     object,
  752.     uuid(B870CE29-A755-11d2-A6A9-00C04FA3490A),
  753.     helpstring("IMessageRouterLinkStateNotification Interface"),
  754.     pointer_default(unique)
  755. ]
  756. interface IMessageRouterLinkStateNotification : IUnknown
  757. {
  758.     HRESULT LinkStateNotify(
  759.         [in] LPSTR                   szLinkDomainName,
  760.         [in] GUID                    guidRouterGUID,
  761.         [in] DWORD                   dwScheduleID,
  762.         [in] LPSTR                   szConnectorName,
  763.         [in] DWORD                   dwLinkState,
  764.         [in] DWORD                   cConsecutiveFailures,
  765.         [in, out] FILETIME           *pftNextScheduled,
  766.         [out] DWORD                 *pdwSetLinkState,
  767.         [out] DWORD                 *pdwUnsetLinkState);
  768. };
  770. //---[ eLinkInfoFlags ]--------------------------------------------------------
  771. //
  772. //
  773. //      Description: Flags used to describe boolean per *link* state.  Used to
  774. //  decide if it is an appropriate time to make a connection.  Event sinks
  775. //  can set and unset these flags to influence the connection manager.
  776. //
  777. //-----------------------------------------------------------------------------
  778. typedef [v1_enum] enum
  779. {
  780.     LINK_STATE_NO_ACTION            = 0x00000000, //NULL op... setting/unsetting this has no effect on link state
  781.     LINK_STATE_RETRY_ENABLED        = 0x00000001, //If NOT set, link is pending retry
  782.     LINK_STATE_SCHED_ENABLED        = 0x00000002, //If NOT set, link is pending scheduled connection
  783.     LINK_STATE_CMD_ENABLED          = 0x00000004, //If set, link should be activated to send a command
  784.     LINK_STATE_ADMIN_HALT           = 0x00000008, //If set, admin has request no connections be made
  785.     LINK_STATE_ADMIN_FORCE_CONN     = 0x00000010, //Admin has requested that a connection be made now
  786.     LINK_STATE_CONNECT_IF_NO_MSGS   = 0x00000020, //Connect even if there are no messages. Link will not be deleted while this is set.
  787.     LINK_STATE_DO_NOT_DELETE        = 0x00000040, //Routing is interested in this link... it should not be deleted by the transport.
  788.     LINK_STATE_CREATE_IF_NECESSARY  = 0x00000080, //Create a new link if one doesn't exist
  789.     LINK_STATE_LINK_NO_LONGER_USED  = 0x00000100, //Set when SMTP is done with link
  790.     LINK_STATE_TYPE_INTERNAL_SMTP   = 0x00000200,
  791.     LINK_STATE_TYPE_EXTERNAL_SMTP   = 0x00000400,
  792.     LINK_STATE_DO_NOT_DELETE_UNTIL_NEXT_NOTIFY = 0x00000800,
  793.     LINK_STATE_RESERVED             = 0xFFFF0000, //Reserved for internal use
  794. } eLinkStateFlags;
  796. //+------------------------------------------------------------
  797. //
  798. // Interface: IMailTransportRoutingEngine
  799. //
  800. // Synopsis: Used for the SMTP_MAILTRANSPORT_ON_GET_ROUTER_FOR_MESSAGE event
  801. //
  802. //
  803. //-------------------------------------------------------------
  805. //
  806. // Specific error code(s) that can be returned from GetMessageRouter
  807. //
  808. cpp_quote("#define ROUTER_E_NOTINTERESTED   MAKE_HRESULT(SEVERITY_ERROR,FACILITY_ITF,0x1000)")
  811. [
  812.     object,
  813.     uuid(A928AD13-1610-11d2-9E02-00C04FA322BA),
  814.     helpstring("IMailTransportRoutingEngine Interface"),
  815.     pointer_default(unique)
  816. ]
  817. interface IMailTransportRoutingEngine : IUnknown
  818. {
  819.     [local]
  820.     HRESULT GetMessageRouter(
  821.         [in]  IMailMsgProperties        *pIMailMsg,
  822.         [in]  IMessageRouter            *pICurrentMessageRouter,
  823.         [out] IMessageRouter          **ppIMessageRouter);
  824. };
  827. cpp_quote("#define MTE_QUEUED_OUTBOUND         1010")
  828. cpp_quote("#define MTE_TRANSFERRED_OUTBOUND    1011")
  829. cpp_quote("#define MTE_RECEIVED_INBOUND        1012")
  830. cpp_quote("#define MTE_TRANSFERRED_INBOUND     1013")
  831. cpp_quote("#define MTE_MESSAGE_REROUTED        1014")
  832. cpp_quote("#define MTE_REPORT_TRANSFERRED_IN   1015")
  833. cpp_quote("#define MTE_REPORT_TRANSFERRED_OUT  1016")
  834. cpp_quote("#define MTE_REPORT_GENERATED        1017")
  835. cpp_quote("#define MTE_REPORT_ABSORBED         1018")
  837. cpp_quote("#define MTE_SUBMIT_MESSAGE_TO_AQ    1019")
  838. cpp_quote("#define MTE_BEGIN_OUTBOUND_TRANSFER 1020")
  839. cpp_quote("#define MTE_BADMAIL                 1021")
  840. cpp_quote("#define MTE_AQ_FAILURE              1022")
  841. cpp_quote("#define MTE_LOCAL_DELIVERY          1023")
  842. cpp_quote("#define MTE_SUBMIT_MESSAGE_TO_CAT   1024")
  843. cpp_quote("#define MTE_BEGIN_SUBMIT_MESSAGE    1025")
  844. cpp_quote("#define MTE_AQ_FAILED_MESSAGE       1026")
  845. cpp_quote("#define MTE_NDR_ALL                 1030")
  846. cpp_quote("#define MTE_END_OUTBOUND_TRANSFER   1031")
  848. [
  849.     helpstring("Interface For Message Tracking."),
  850.     local,
  851.     object,
  852.     pointer_default(unique),
  853.     uuid(1bc3580e-7e4f-11d2-94f4-00C04f79f1d6)
  854. ]
  855. interface IMsgTrackLog : IUnknown
  856. {
  857.     HRESULT OnSyncLogMsgTrackInfo(
  858.                 [in] IUnknown *pIServer,
  859.                 [in] IMailMsgProperties *pIMailMsgProp,
  860.                 [in] LPMSG_TRACK_INFO pMsgTrackInfo);
  861. };
  864. [
  865.     helpstring("Interface For Enumerating Resolver Records."),
  866.     local,
  867.     object,
  868.     pointer_default(unique),
  869.     uuid(e5b89c52-8e0b-11d2-94f6-00C04f79f1d6)
  870. ]
  871. interface IDnsResolverRecord : IUnknown
  872. {
  873.     HRESULT GetItem( [in] ULONG cIndex, [out] LPSTR *ppszHostName, [out] DWORD *pAddr );
  874.     HRESULT Count( [out] DWORD *pcRecords );
  875. };
  877. [
  878.     helpstring("Interface For Getting Resolver Records."),
  879.     local,
  880.     object,
  881.     pointer_default(unique),
  882.     uuid(d95a4d0c-8e06-11d2-94f6-00C04f79f1d6)
  883. ]
  884. interface IDnsResolverRecordSink : IUnknown
  885. {
  886.     HRESULT OnSyncGetResolverRecord( [in] LPSTR pszHostName,
  887.                                      [in] LPSTR pszInstanceFQDN,
  888.                                      [in] DWORD dwVirtualServerId,
  889.                                      [out] IDnsResolverRecord **ppDnsResolverRecord);
  890. };
  892. [
  893.     helpstring("MaxMsgSize Exceeded event interface."),
  894.     local,
  895.     object,
  896.     pointer_default(unique),
  897.     uuid(b997f192-a67d-11d2-94f7-00C04f79f1d6)
  898. ]
  899. interface ISmtpMaxMsgSize : IUnknown
  900. {
  901.     HRESULT OnSyncMaxMsgSize( [in]  IUnknown            *pIUnknown,
  902.                               [in]  IMailMsgProperties  *pIMailMsgProp,
  903.                               [out] BOOL                *pfShouldImposeLimit );
  904. };
  906. [
  907.     helpstring("Log event interface."),
  908.     local,
  909.     object,
  910.     pointer_default(unique),
  911.     uuid(35bc9ad7-7aa5-43ee-a0ab-94e1d6be99e5)
  912. ]
  913. interface ISmtpLog : IUnknown
  914. {
  915.     HRESULT OnSyncLog(
  916.                 [in] LPSMTP_LOG_EVENT_INFO pLogEventInfo);
  917. };
  919. [
  920.     helpstring("Get Aux Domain Info Flags event interface."),
  921.     local,
  922.     object,
  923.     pointer_default(unique),
  924.     uuid(d038c9da-4977-491d-8b0e-97f2e546c35a)
  925. ]
  926. interface ISmtpGetAuxDomainInfoFlags : IUnknown
  927. {
  928.     HRESULT OnGetAuxDomainInfoFlags(
  929.                 [in]    IUnknown               *pIServer,
  930.                 [in]    LPCSTR                  pszDomainName,
  931.                 [out]   DWORD                  *pdwDomainInfoFlags );
  932. };
  934. //+------------------------------------------------------------
  935. //
  936. // The Categorizer event interfaces:
  937. //
  938. //-------------------------------------------------------------
  940. interface ICategorizerListResolve;
  941. interface ICategorizerItemAttributes;
  942. interface ICategorizerMailMsgs;
  943. interface ICategorizerItem;
  944. interface ICategorizerDomainInfo;
  945. interface ISMTPCategorizer;
  946. interface ISMTPCategorizerCompletion;
  947. interface ISMTPCategorizerDLCompletion;
  949. //
  950. // A structure and definitions to handle the configuration of
  951. // a virtual server (for categorizer)
  952. //
  953. typedef [v1_enum] enum
  954. {
  955.     CCAT_CONFIG_INFO_FLAGS                      = 0x0001,
  956.     CCAT_CONFIG_INFO_ROUTINGTYPE                = 0x0002,
  957.     CCAT_CONFIG_INFO_BINDDOMAIN                 = 0x0004,
  958.     CCAT_CONFIG_INFO_USER                       = 0x0008,
  959.     CCAT_CONFIG_INFO_PASSWORD                   = 0x0010,
  960.     CCAT_CONFIG_INFO_BINDTYPE                   = 0x0020,
  961.     CCAT_CONFIG_INFO_SCHEMATYPE                 = 0x0040,
  962.     CCAT_CONFIG_INFO_HOST                       = 0x0080,
  963.     CCAT_CONFIG_INFO_NAMINGCONTEXT              = 0x0100,
  964.     CCAT_CONFIG_INFO_DEFAULTDOMAIN              = 0x0200,
  965.     CCAT_CONFIG_INFO_PORT                       = 0x0400,
  966.     CCAT_CONFIG_INFO_ISMTPSERVER                = 0x0800,
  967.     CCAT_CONFIG_INFO_IDOMAININFO                = 0x1000,
  968.     CCAT_CONFIG_INFO_ENABLE                     = 0x2000,
  969.     CCAT_CONFIG_INFO_DEFAULT                    = 0x4000,
  970.     CCAT_CONFIG_INFO_VSID                       = 0x8000,
  971.     CCAT_CONFIG_INFO_ALL                        = 0xFFFF
  972. } eCatConfigInfoFlags;
  974. typedef struct _tagCCatConfigInfo {
  976.     DWORD dwCCatConfigInfoFlags;    //Flags describing which fields
  977.                                     //are valid
  978.     DWORD dwEnable;
  979.     DWORD dwCatFlags;
  980.     LPSTR pszRoutingType;
  981.     LPSTR pszBindDomain;
  982.     LPSTR pszUser;
  983.     LPSTR pszPassword;
  984.     LPSTR pszBindType;
  985.     LPSTR pszSchemaType;
  986.     LPSTR pszHost;
  987.     LPSTR pszNamingContext;
  988.     LPSTR pszDefaultDomain;
  989.     DWORD dwPort;
  990.     ISMTPServer *pISMTPServer;
  991.     ICategorizerDomainInfo *pIDomainInfo;
  992.     DWORD dwVirtualServerID;
  994. } CCATCONFIGINFO, *PCCATCONFIGINFO;
  996. typedef [v1_enum] enum _CAT_ADDRESS_TYPE {
  997.     CAT_SMTP            = 0, // SMTP address type
  998.     CAT_X500            = 1, // X500 address type (ex: "/DC=blah/dc=...")
  999.     CAT_X400            = 2, // X400 address type
  1000.     CAT_DN              = 3, // Distinguished Name
  1001.     CAT_LEGACYEXDN      = 4, // LegacyExchangeDN attribute
  1002.     CAT_CUSTOMTYPE      = 5, // Foreign address type
  1003.     CAT_UNKNOWNTYPE     = 6, // Not a valid input value
  1004. } CAT_ADDRESS_TYPE;
  1006. //+------------------------------------------------------------
  1007. //
  1008. // Interface: ICategorizerProperties
  1009. //
  1010. // Synopsis: Property setting/retrieval interface
  1011. //
  1012. //
  1013. //-------------------------------------------------------------
  1014. [
  1015.     local,
  1016.     object,
  1017.     uuid(96BF3199-79D8-11d2-9E11-00C04FA322BA),
  1018.     helpstring("ICategorizerProperties Interface"),
  1019.     pointer_default(unique)
  1020. ]
  1021. interface ICategorizerProperties : IUnknown
  1022. {
  1023.     HRESULT GetStringA(
  1024.         [in]  DWORD dwPropId,
  1025.         [in]  DWORD dwcchValue,
  1026.         [out, size_is(dwcchValue)] LPSTR pszValue);
  1027.     HRESULT PutStringA(
  1028.         [in]  DWORD dwPropId,
  1029.         [in, unique] LPSTR pszValue);
  1030.     HRESULT GetDWORD(
  1031.         [in]  DWORD dwPropId,
  1032.         [out] DWORD *pdwValue);
  1033.     HRESULT PutDWORD(
  1034.         [in]  DWORD dwPropId,
  1035.         [in]  DWORD dwValue);
  1036.     HRESULT GetHRESULT(
  1037.         [in]  DWORD dwPropId,
  1038.         [out] HRESULT *phrValue);
  1039.     HRESULT PutHRESULT(
  1040.         [in]  DWORD dwPropId,
  1041.         [in]  HRESULT hrValue);
  1042.     HRESULT GetBool(
  1043.         [in]  DWORD dwPropId,
  1044.         [out] BOOL  *pfValue);
  1045.     HRESULT PutBool(
  1046.         [in]  DWORD dwPropId,
  1047.         [in]  BOOL  fValue);
  1048.     HRESULT GetPVoid(
  1049.         [in]  DWORD dwPropId,
  1050.         [out] PVOID *pvValue);
  1051.     HRESULT PutPVoid(
  1052.         [in]  DWORD dwPropId,
  1053.         [in]  PVOID pvValue);
  1054.     HRESULT GetIUnknown(
  1055.         [in]  DWORD dwPropId,
  1056.         [out] IUnknown **pUnknown);
  1057.     HRESULT PutIUnknown(
  1058.         [in]  DWORD dwPropId,
  1059.         [in]  IUnknown *pUnknown);
  1060.     HRESULT GetIMailMsgProperties(
  1061.         [in]  DWORD dwPropId,
  1062.         [out] IMailMsgProperties **ppIMsg);
  1063.     HRESULT PutIMailMsgProperties(
  1064.         [in]  DWORD dwPropId,
  1065.         [in]  IMailMsgProperties *pIMsg);
  1066.     HRESULT GetIMailMsgRecipientsAdd(
  1067.         [in]  DWORD dwPropId,
  1068.         [out] IMailMsgRecipientsAdd **ppIMsgRecipientsAdd);
  1069.     HRESULT PutIMailMsgRecipientsAdd(
  1070.         [in]  DWORD dwPropId,
  1071.         [in]  IMailMsgRecipientsAdd *pIMsgRecipientsAdd);
  1072.     HRESULT GetICategorizerItemAttributes(
  1073.         [in]  DWORD dwPropId,
  1074.         [out] ICategorizerItemAttributes **ppICategorizerItemAttributes);
  1075.     HRESULT PutICategorizerItemAttributes(
  1076.         [in]  DWORD dwPropId,
  1077.         [in]  ICategorizerItemAttributes *pICategorizerItemAttributes);
  1078.     HRESULT GetICategorizerListResolve(
  1079.         [in]  DWORD dwPropId,
  1080.         [out] ICategorizerListResolve **ppICategorizerListResolve);
  1081.     HRESULT PutICategorizerListResolve(
  1082.         [in]  DWORD dwPropId,
  1083.         [in]  ICategorizerListResolve *pICategorizerListResolve);
  1084.     HRESULT GetICategorizerMailMsgs(
  1085.         [in]  DWORD dwPropId,
  1086.         [out] ICategorizerMailMsgs **ppICategorizerMailMsgs);
  1087.     HRESULT PutICategorizerMailMsgs(
  1088.         [in]  DWORD dwPropId,
  1089.         [in]  ICategorizerMailMsgs *pICategorizerMailMsgs);
  1090.     HRESULT GetICategorizerItem(
  1091.         [in]  DWORD dwPropId,
  1092.         [out] ICategorizerItem **ppICategorizerItem);
  1093.     HRESULT PutICategorizerItem(
  1094.         [in]  DWORD dwPropId,
  1095.         [in]  ICategorizerItem *pICategorizerItem);
  1096.     HRESULT UnSetPropId(
  1097.         [in]  DWORD dwPropId);
  1098. };
  1101. //+------------------------------------------------------------
  1102. //
  1103. // Interface: ICategorizerParameters
  1104. //
  1105. // Synopsis: Holds data concerning attribute names for the schema in use
  1106. //
  1107. //
  1108. //-------------------------------------------------------------
  1109. typedef [v1_enum] enum
  1110. {
  1111.     DSPARAMETER_LDAPHOST = 0,
  1112.     DSPARAMETER_LDAPBINDTYPE,
  1113.     DSPARAMETER_LDAPDOMAIN,
  1114.     DSPARAMETER_LDAPACCOUNT,
  1115.     DSPARAMETER_LDAPPASSWORD,
  1116.     DSPARAMETER_LDAPNAMINGCONTEXT,
  1117.     DSPARAMETER_LDAPPORT,
  1118.     DSPARAMETER_BATCHINGLIMIT,
  1120.     DSPARAMETER_SEARCHATTRIBUTE_SMTP,
  1121.     DSPARAMETER_SEARCHFILTER_SMTP,
  1122.     DSPARAMETER_SEARCHATTRIBUTE_X500,
  1123.     DSPARAMETER_SEARCHFILTER_X500,
  1124.     DSPARAMETER_SEARCHATTRIBUTE_X400,
  1125.     DSPARAMETER_SEARCHFILTER_X400,
  1126.     DSPARAMETER_SEARCHATTRIBUTE_LEGACYEXDN,
  1127.     DSPARAMETER_SEARCHFILTER_LEGACYEXDN,
  1128.     DSPARAMETER_SEARCHATTRIBUTE_RDN,
  1129.     DSPARAMETER_SEARCHFILTER_RDN,
  1130.     DSPARAMETER_SEARCHATTRIBUTE_DN,
  1131.     DSPARAMETER_SEARCHFILTER_DN,
  1132.     DSPARAMETER_SEARCHATTRIBUTE_FOREIGNADDRESS,
  1133.     DSPARAMETER_SEARCHFILTER_FOREIGNADDRESS,
  1135.     DSPARAMETER_ATTRIBUTE_OBJECTCLASS,
  1136.     DSPARAMETER_ATTRIBUTE_DEFAULT_SMTP,
  1137.     DSPARAMETER_ATTRIBUTE_DEFAULT_X500,
  1138.     DSPARAMETER_ATTRIBUTE_DEFAULT_X400,
  1139.     DSPARAMETER_ATTRIBUTE_DEFAULT_DN,
  1140.     DSPARAMETER_ATTRIBUTE_DEFAULT_LEGACYEXDN,
  1142.     DSPARAMETER_ATTRIBUTE_FORWARD_SMTP,
  1143.     DSPARAMETER_ATTRIBUTE_DL_MEMBERS,
  1144.     DSPARAMETER_ATTRIBUTE_DL_DYNAMICFILTER,
  1145.     DSPARAMETER_ATTRIBUTE_DL_DYNAMICBASEDN,
  1147.     DSPARAMETER_OBJECTCLASS_USER,
  1148.     DSPARAMETER_OBJECTCLASS_DL_X500,
  1149.     DSPARAMETER_OBJECTCLASS_DL_SMTP,
  1150.     DSPARAMETER_OBJECTCLASS_DL_DYNAMIC,
  1151.     DSPARAMETER_ENDENUMMESS,
  1152.     DSPARAMETER_INVALID
  1153. } eDSPARAMETER;
  1156. [
  1157.     object,
  1158.     local,
  1159.     uuid(86F9DA7B-EB6E-11d1-9DF3-00C04FA322BA),
  1160.     helpstring("ICategorizerParameters Interface"),
  1161.     pointer_default(unique)
  1162. ]
  1163. interface ICategorizerParameters : IUnknown
  1164. {
  1165.     HRESULT GetDSParameterA(
  1166.         [in]  DWORD dwDSParameter,
  1167.         [out] LPSTR *ppszValue);
  1169.     HRESULT SetDSParameterA(
  1170.         [in] DWORD dwDSParameter,
  1171.         [in, unique] LPCSTR pszValue);
  1173.     HRESULT RequestAttributeA(
  1174.         [in, unique] LPCSTR pszName);
  1176.     HRESULT GetAllAttributes(
  1177.         [out] LPSTR **prgszAllAttributes);
  1179.     HRESULT ReserveICatItemPropIds(
  1180.         [in]  DWORD   dwNumPropIdsRequested,
  1181.         [out] DWORD   *pdwBeginningPropId);
  1183.     HRESULT ReserveICatListResolvePropIds(
  1184.         [in]  DWORD   dwNumPropIdsRequested,
  1185.         [out] DWORD   *pdwBeginningPropId);
  1187.     HRESULT GetCCatConfigInfo(
  1188.         [out] PCCATCONFIGINFO *ppCCatConfigInfo);
  1189. };
  1192. //+------------------------------------------------------------
  1193. //
  1194. // Interface: ICategorizerQueries
  1195. //
  1196. // Synopsis: Interface to an object that holds query strings
  1197. //
  1198. //
  1199. //-------------------------------------------------------------
  1200. [
  1201.     object,
  1202.     uuid(86F9DA7D-EB6E-11d1-9DF3-00C04FA322BA),
  1203.     helpstring("ICategorizerQueries Interface"),
  1204.     pointer_default(unique)
  1205. ]
  1206. interface ICategorizerQueries : IUnknown
  1207. {
  1208.     HRESULT SetQueryString(
  1209.         [in, unique] LPSTR pszQueryString);
  1210.     HRESULT GetQueryString(
  1211.         [out] LPSTR *ppszQueryString);
  1212. };
  1214. //+------------------------------------------------------------
  1215. //
  1216. // Interface: ICategorizerMailMsgs
  1217. //
  1218. // Synopsis: Interface to hold all MailMsgs associated with a message
  1219. //           categorization
  1220. //
  1221. //-------------------------------------------------------------
  1222. //
  1223. // The structure used for mailmsg enumeration
  1224. //
  1225. typedef PVOID CATMAILMSG_ENUMERATOR, *PCATMAILMSG_ENUMERATOR;
  1227. [
  1228.     object,
  1229.     local,
  1230.     uuid(86F9DA80-EB6E-11d1-9DF3-00C04FA322BA),
  1231.     helpstring("ICategorizerMailMsgs Interface"),
  1232.     pointer_default(unique)
  1233. ]
  1234. interface ICategorizerMailMsgs : IUnknown
  1235. {
  1236.     HRESULT GetMailMsg(
  1237.         [in]  DWORD dwFlags,
  1238.         [out] IMailMsgProperties **ppIMailMsgProperties,
  1239.         [out] IMailMsgRecipientsAdd **ppIMailMsgRecipientsAdd,
  1240.         [out] BOOL *pfCreated);
  1242.     HRESULT ReBindMailMsg(
  1243.         [in]  DWORD dwFlags,
  1244.         [in]  IUnknown *pStoreDriver);
  1246.     //
  1247.     // Functions to enumerate all created mailmsg
  1248.     //
  1249.     HRESULT BeginMailMsgEnumeration(
  1250.         [in]  PCATMAILMSG_ENUMERATOR penumerator);
  1252.     HRESULT GetNextMailMsg(
  1253.         [in]  PCATMAILMSG_ENUMERATOR penumerator,
  1254.         [out] DWORD *pdwFlags,
  1255.         [out] IMailMsgProperties **ppIMailMsgProperties,
  1256.         [out] IMailMsgRecipientsAdd **ppIMailMsgRecipientsAdd);
  1258.     HRESULT EndMailMsgEnumeration(
  1259.         [in]  PCATMAILMSG_ENUMERATOR penumerator);
  1260. }
  1262. //+------------------------------------------------------------
  1263. //
  1264. // Interface: ICategorizerItemAttributes
  1265. //
  1266. // Synopsis: Sink supplied interface with methods to get at object attributes
  1267. //
  1268. //
  1269. //-------------------------------------------------------------
  1270. //
  1271. // The structure used for attribute enumeration
  1272. //
  1273. typedef struct _tagAttributeEnumerator {
  1274.     PVOID pvBase;
  1275.     PVOID pvCurrent;
  1276.     PVOID pvContext;
  1277. } ATTRIBUTE_ENUMERATOR, *PATTRIBUTE_ENUMERATOR;
  1279. [
  1280.     object,
  1281.     uuid(86F9DA7F-EB6E-11d1-9DF3-00C04FA322BA),
  1282.     helpstring("ICategorizerItemAttributes Interface"),
  1283.     pointer_default(unique)
  1284. ]
  1285. interface ICategorizerItemAttributes : IUnknown
  1286. {
  1287.     //
  1288.     // Functions to enumerate through a specified attribute value
  1289.     //
  1290.     [local] HRESULT BeginAttributeEnumeration(
  1291.         [in, unique] LPCSTR pszAttributeName,
  1292.         [in] PATTRIBUTE_ENUMERATOR penumerator);
  1294.     [local] HRESULT GetNextAttributeValue(
  1295.         [in] PATTRIBUTE_ENUMERATOR penumerator,
  1296.         [out] LPSTR *ppszAttributeValue);
  1298.     [local] HRESULT RewindAttributeEnumeration(
  1299.         [in] PATTRIBUTE_ENUMERATOR penumerator);
  1301.     [local] HRESULT EndAttributeEnumeration(
  1302.         [in] PATTRIBUTE_ENUMERATOR penumerator);
  1304.     //
  1305.     // Functions to enumerate through the available attribute names
  1306.     //
  1307.     [local] HRESULT BeginAttributeNameEnumeration(
  1308.         [in] PATTRIBUTE_ENUMERATOR penumerator);
  1310.     [local] HRESULT GetNextAttributeName(
  1311.         [in] PATTRIBUTE_ENUMERATOR penumerator,
  1312.         [out] LPSTR *ppszAttributeName);
  1314.     [local] HRESULT EndAttributeNameEnumeration(
  1315.         [in] PATTRIBUTE_ENUMERATOR penumerator);
  1317.     [local] GUID GetTransportSinkID();
  1319.     [local] HRESULT AggregateAttributes(
  1320.         [in] ICategorizerItemAttributes *pICatItemAttr);
  1322.     //
  1323.     // Support to retrieve all attributes at the same time.
  1324.     //
  1325.     [local] HRESULT GetAllAttributeValues(
  1326.         [in, unique] LPCSTR pszAttributeName,
  1327.         [in] PATTRIBUTE_ENUMERATOR penumerator,
  1328.         [out] LPSTR **prgpszAttributeValues);
  1330.     [local] HRESULT ReleaseAllAttributeValues(
  1331.         [in] PATTRIBUTE_ENUMERATOR penumerator);
  1333.     //
  1334.     // Count the attribute values before enumeating
  1335.     //
  1336.     [local] HRESULT CountAttributeValues(
  1337.         [in]  PATTRIBUTE_ENUMERATOR penumerator,
  1338.         [out] DWORD *pdwCount);
  1339. }
  1341. //+------------------------------------------------------------
  1342. //
  1343. // Interface: ICategorizerItemRawAttributes
  1344. //
  1345. // Synopsis: Sink supplied interface with methods to get at raw object attributes
  1346. //
  1347. //
  1348. //-------------------------------------------------------------
  1349. [
  1350.     object,
  1351.     uuid(34C3D389-8FA7-11d2-9E16-00C04FA322BA),
  1352.     helpstring("ICategorizerItemRawAttributes Interface"),
  1353.     pointer_default(unique)
  1354. ]
  1355. interface ICategorizerItemRawAttributes : IUnknown
  1356. {
  1357.     //
  1358.     // Functions to enumerate through a specified attribute value
  1359.     //
  1360.     [local] HRESULT BeginRawAttributeEnumeration(
  1361.         [in, unique] LPCSTR pszAttributeName,
  1362.         [in] PATTRIBUTE_ENUMERATOR penumerator);
  1364.     [local] HRESULT GetNextRawAttributeValue(
  1365.         [in] PATTRIBUTE_ENUMERATOR penumerator,
  1366.         [out] DWORD *pdwcb,
  1367.         [out] LPVOID *pvAttributeValue);
  1369.     [local] HRESULT RewindRawAttributeEnumeration(
  1370.         [in] PATTRIBUTE_ENUMERATOR penumerator);
  1372.     [local] HRESULT EndRawAttributeEnumeration(
  1373.         [in] PATTRIBUTE_ENUMERATOR penumerator);
  1375.     //
  1376.     // Count the attribute values before enumeating
  1377.     //
  1378.     [local] HRESULT CountRawAttributeValues(
  1379.         [in]  PATTRIBUTE_ENUMERATOR penumerator,
  1380.         [out] DWORD *pdwCount);
  1381. }
  1383. //+------------------------------------------------------------
  1384. //
  1385. // Interface: ICategorizerItem
  1386. //
  1387. // Synopsis: A property interface with a number of well known propIDs
  1388. //           (below)
  1389. //
  1390. //
  1391. //-------------------------------------------------------------
  1392. typedef [v1_enum] enum
  1393. {
  1394.     ICATEGORIZERITEM_SOURCETYPE = 0,
  1395.     ICATEGORIZERITEM_LDAPQUERYSTRING,
  1396.     ICATEGORIZERITEM_DISTINGUISHINGATTRIBUTE,
  1397.     ICATEGORIZERITEM_DISTINGUISHINGATTRIBUTEVALUE,
  1398.     ICATEGORIZERITEM_IMAILMSGPROPERTIES,
  1399.     ICATEGORIZERITEM_IMAILMSGRECIPIENTSADD,
  1400.     ICATEGORIZERITEM_IMAILMSGRECIPIENTSADDINDEX,
  1401.     ICATEGORIZERITEM_FPRIMARY,
  1402.     ICATEGORIZERITEM_PARENT,
  1403.     ICATEGORIZERITEM_ICATEGORIZERITEMATTRIBUTES,
  1404.     ICATEGORIZERITEM_HRSTATUS,
  1405.     ICATEGORIZERITEM_ICATEGORIZERLISTRESOLVE,
  1406.     ICATEGORIZERITEM_ICATEGORIZERMAILMSGS,
  1407.     ICATEGORIZERITEM_HRNDRREASON,
  1408.     ICATEGORIZERITEM_DWLEVEL,
  1409.     ICATEGORIZERITEM_ENDENUMMESS
  1410. } eICATEGORIZERITEMPROPID;
  1412. typedef [v1_enum] enum
  1413. {
  1414.     SOURCE_SENDER,
  1415.     SOURCE_RECIPIENT,
  1416.     SOURCE_VERIFY
  1417. } eSourceType;
  1419. [
  1420.     local,
  1421.     object,
  1422.     uuid(86F9DA7C-EB6E-11d1-9DF3-00C04FA322BA),
  1423.     helpstring("ICategorizerItem Interface"),
  1424.     pointer_default(unique)
  1425. ]
  1426. interface ICategorizerItem : ICategorizerProperties {};
  1430. //+------------------------------------------------------------
  1431. //
  1432. // Interface: ICategorizerAsyncContext
  1433. //
  1434. // Synopsis: Interface handed out to sinks containing async context methods
  1435. //
  1436. //
  1437. //-------------------------------------------------------------
  1438. [
  1439.     object,
  1440.     uuid(86F9DA7E-EB6E-11d1-9DF3-00C04FA322BA),
  1441.     helpstring("ICategorizerAsyncCompletion Interface"),
  1442.     pointer_default(unique)
  1443. ]
  1444. interface ICategorizerAsyncContext : IUnknown
  1445. {
  1446.     [local] HRESULT CompleteQuery(
  1447.         [in] PVOID pvQueryContext,
  1448.         [in] HRESULT hrResolutionStatus,
  1449.         [in] DWORD dwcResults,
  1450.         [in, size_is(dwcResults)] ICategorizerItemAttributes **rgpItemAttributes,
  1451.         [in] BOOL fFinalCompletion);
  1452. }
  1454. //+------------------------------------------------------------
  1455. //
  1456. // Interface: ICategorizerListResolve
  1457. //
  1458. // Synopsis: Interface handed out to sinks that can spin off further resolves
  1459. //
  1460. //
  1461. //-------------------------------------------------------------
  1462. [
  1463.     object,
  1464.     uuid(960252A4-0A3A-11d2-9E00-00C04FA322BA),
  1465.     helpstring("ICategorizerListResolve Interface"),
  1466.     pointer_default(unique)
  1467. ]
  1468. interface ICategorizerListResolve : IUnknown
  1469. {
  1470.     [local] HRESULT AllocICategorizerItem(
  1471.         [in]  eSourceType SourceType,
  1472.         [out] ICategorizerItem **ppICatItem);
  1474.     [local] HRESULT ResolveICategorizerItem(
  1475.         [in] ICategorizerItem *pICatItem);
  1477.     [local] HRESULT SetListResolveStatus(
  1478.         [in] HRESULT hrStatus);
  1480.     [local] HRESULT GetListResolveStatus(
  1481.         [out] HRESULT *phrStatus);
  1482. }
  1484. //+------------------------------------------------------------
  1485. //
  1486. // Interface: IMailTransportCategorize
  1487. //
  1488. // Synopsis: Interface a sink must implement in order to handle
  1489. //           categorizer events
  1490. //
  1491. //
  1492. //-------------------------------------------------------------
  1493. [
  1494.     object,
  1495.     uuid(86F9DA7A-EB6E-11d1-9DF3-00C04FA322BA),
  1496.     helpstring("IMailTransportCategorize Interface"),
  1497.     pointer_default(unique)
  1499. ]
  1500. interface IMailTransportCategorize : IUnknown
  1501. {
  1502.     HRESULT Register(
  1503.         [in]  ICategorizerParameters *);
  1505.     [local] HRESULT BeginMessageCategorization(
  1506.         [in]  ICategorizerMailMsgs *);
  1508.     [local] HRESULT EndMessageCategorization(
  1509.         [in]  ICategorizerMailMsgs *,
  1510.         [in]  HRESULT hrCatStatus);
  1512.     [local] HRESULT BuildQuery(
  1513.         [in]  ICategorizerParameters *,
  1514.         [in]  ICategorizerItem *);
  1516.     [local] HRESULT BuildQueries(
  1517.         [in]  ICategorizerParameters *,
  1518.         [in]  DWORD dwcAddresses,
  1519.         [in, size_is(dwcAddresses)] ICategorizerItem **rgpICategorizerItems,
  1520.         [in]  ICategorizerQueries *);
  1522.     [local] HRESULT SendQuery(
  1523.         [in]  ICategorizerParameters *,
  1524.         [in]  ICategorizerQueries *,
  1525.         [in]  ICategorizerAsyncContext *,
  1526.         [in]  PVOID pvQueryContext);
  1528.     [local] HRESULT SortQueryResult(
  1529.         [in]  ICategorizerParameters *,
  1530.         [in]  HRESULT hrResolutionStatus,
  1531.         [in]  DWORD dwcAddresses,
  1532.         [in, size_is(dwcAddresses)] ICategorizerItem **rgpICategorizerItems,
  1533.         [in]  DWORD dwcResults,
  1534.         [in, size_is(dwcResults)] ICategorizerItemAttributes **rgpICategorizerItemAttributes);
  1536.     [local] HRESULT ProcessItem(
  1537.         [in]  ICategorizerParameters *,
  1538.         [in]  ICategorizerItem *);
  1540.     [local] HRESULT ExpandItem(
  1541.         [in]  ICategorizerParameters *,
  1542.         [in]  ICategorizerItem *,
  1543.         [in]  IMailTransportNotify *,
  1544.         [in]  PVOID);
  1546.     [local] HRESULT CompleteItem(
  1547.         [in]  ICategorizerParameters *,
  1548.         [in]  ICategorizerItem *);
  1549. };
  1551. //
  1552. // See smtpguid.h for the CLSID and Program ID of the CoCreateable
  1553. // Categorizer
  1554. //
  1556. //+------------------------------------------------------------
  1557. //
  1558. // Interface: ISMTPCategorizer
  1559. //
  1560. // Synopsis: Interface to the SMTP categorizer
  1561. //
  1562. //
  1563. //-------------------------------------------------------------
  1564. [
  1565.     object,
  1566.     local,
  1567.     uuid(B23C35B8-9219-11d2-9E17-00C04FA322BA),
  1568.     helpstring("ISMTPCategorizer Interface"),
  1569.     pointer_default(unique)
  1570. ]
  1571. interface ISMTPCategorizer : IUnknown
  1572. {
  1573.     HRESULT ChangeConfig(
  1574.         [in]  PCCATCONFIGINFO pConfigInfo);
  1576.     HRESULT CatMsg(
  1577.         [in]  IUnknown *pMsg,
  1578.         [in]  ISMTPCategorizerCompletion *pICompletion,
  1579.         [in]  LPVOID pContext);
  1581.     HRESULT CatDLMsg(
  1582.         [in]  IUnknown *pMsg,
  1583.         [in]  ISMTPCategorizerDLCompletion *pICompletion,
  1584.         [in]  LPVOID pContext,
  1585.         [in]  BOOL fMatchOnly,
  1586.         [in]  CAT_ADDRESS_TYPE CAType,
  1587.         [in]  LPSTR pszAddress);
  1589.     HRESULT CatCancel();
  1590. };
  1593. //+------------------------------------------------------------
  1594. //
  1595. // Interface: ISMTPCategorizerCompletion
  1596. //
  1597. // Synopsis: Async completion interface
  1598. //
  1599. //
  1600. //-------------------------------------------------------------
  1601. [
  1602.     object,
  1603.     local,
  1604.     uuid(B23C35B9-9219-11d2-9E17-00C04FA322BA),
  1605.     helpstring("ISMTPCategorizerCompletion Interface"),
  1606.     pointer_default(unique)
  1607. ]
  1608. interface ISMTPCategorizerCompletion : IUnknown
  1609. {
  1610.     HRESULT CatCompletion(
  1611.         HRESULT hr,
  1612.         PVOID pContext,
  1613.         IUnknown *pImsg,
  1614.         IUnknown **rgpImsg);
  1615. };
  1617. //+------------------------------------------------------------
  1618. //
  1619. // Interface: ISMTPCategorizerDLCompletion
  1620. //
  1621. // Synopsis: Async completion interface
  1622. //
  1623. //
  1624. //-------------------------------------------------------------
  1625. [
  1626.     object,
  1627.     local,
  1628.     uuid(B23C35BA-9219-11d2-9E17-00C04FA322BA),
  1629.     helpstring("ISMTPCategorizerDLCompletion Interface"),
  1630.     pointer_default(unique)
  1631. ]
  1632. interface ISMTPCategorizerDLCompletion : IUnknown
  1633. {
  1634.     HRESULT CatDLCompletion(
  1635.         HRESULT hr,
  1636.         PVOID pContext,
  1637.         IUnknown *pImsg,
  1638.         BOOL fMatch);
  1639. };
  1641. //---[ eDomainInfoFlags ]------------------------------------------------------
  1642. //
  1643. //
  1644. //      Description: Flags used to describe boolean per domain properties
  1645. //
  1646. //-----------------------------------------------------------------------------
  1647. typedef [v1_enum] enum
  1648. {
  1649.     //Outbound protocol property flags
  1650.     DOMAIN_INFO_REMOTE              = 0x00000000, //Default setting
  1651.     DOMAIN_INFO_USE_SSL             = 0x00000001, //Use SSL on outbound connections
  1652.     DOMAIN_INFO_SEND_TURN           = 0x00000002, //Send TURN on outbound connections
  1653.     DOMAIN_INFO_SEND_ETRN           = 0x00000004, //Send ETRN on outbound connections
  1654.     DOMAIN_INFO_USE_NTLM            = 0x00000008, //Use NTLM auth on outbound
  1655.     DOMAIN_INFO_USE_PLAINTEXT       = 0x00000010, //Use plaintext auth on outbound
  1656.     DOMAIN_INFO_USE_DPA             = 0x00000020, //Use DPA auth on outbound
  1657.     DOMAIN_INFO_USE_KERBEROS        = 0x00000040, //Use Kerberos auth on outbound
  1658.     DOMAIN_INFO_USE_CHUNKING        = 0x00000080, //Require binary chunking on outbound
  1659.     DOMAIN_INFO_DISABLE_CHUNKING    = 0x00000100, //For this specific domain disaalow CHUNKING
  1660.     DOMAIN_INFO_DISABLE_BMIME       = 0x00000200, //For this specific domain disallow BMIME
  1661.     DOMAIN_INFO_DISABLE_DSN         = 0x00000400, //For this specific domain disallow DSN
  1662.     DOMAIN_INFO_DISABLE_PIPELINE    = 0x00000800, //For this specific domain disallow PIPElineing
  1663.     DOMAIN_INFO_USE_HELO            = 0x00001000, //Send HELO instead of EHLO
  1665.     //Queueing/Routing flags
  1666.     DOMAIN_INFO_TURN_ONLY           = 0x00010000, //Create connection only when asked (uses GetNamedConnection)
  1667.     DOMAIN_INFO_ETRN_ONLY           = 0x00020000, //Do no create connections until told to (uses GetNextConnection)
  1668.     DOMAIN_INFO_LOCAL_DROP          = 0x00040000, //Local drop domain
  1669.     DOMAIN_INFO_LOCAL_MAILBOX       = 0x00080000, //Local domain (no drop directory)
  1670.     DOMAIN_INFO_REMOTE_SMARTHOST    = 0x00100000, //Remote domain with smart host
  1671.     DOMAIN_INFO_IP_RELAY            = 0x00200000, //Allow Relay based on IP address
  1672.     DOMAIN_INFO_AUTH_RELAY          = 0x00400000, //Allow Relay based on authentication
  1673.     DOMAIN_INFO_DOMAIN_RELAY        = 0x00800000, //Allow Relay based on domain name
  1674.     DOMAIN_INFO_ALIAS               = 0x01000000, //Local alias domain
  1675.     DOMAIN_INFO_TURN_ON_EMPTY       = 0x02000000, //TURN works on empty conns
  1677.     DOMAIN_INFO_INVALID             = 0x80000000, //Used for returning "invalid" or "not found" info
  1678. } eDomainInfoFlags ;
  1680. //+------------------------------------------------------------
  1681. //
  1682. // Interface: ICategorizerDomainInfo
  1683. //
  1684. // Synopsis: An interface to retrieve above domain info flags
  1685. //           describing a given SMTP domain
  1686. //
  1687. //-------------------------------------------------------------
  1688. [
  1689.     object,
  1690.     local,
  1691.     uuid(E210EDC6-F27D-481f-9DFC-1CA840905FD9),
  1692.     helpstring("ICategorizerDomainInfo Interface"),
  1693.     pointer_default(unique)
  1694. ]
  1695. interface ICategorizerDomainInfo : IUnknown
  1696. {
  1697.     HRESULT GetDomainInfoFlags(
  1698.         [in, string] LPSTR szDomainName,
  1699.         [out]        DWORD *pdwDomainInfoFlags);
  1700. }
  1703. //+------------------------------------------------------------
  1704. //
  1705. // Interfaces pulled in from catintrnl.idl
  1706. //
  1708. interface ICategorizerRequestedAttributes;
  1709. interface ICategorizerLdapConfig;
  1710. interface IServersListInfo;
  1712. //+------------------------------------------------------------
  1713. //
  1714. // Interface: ICategorizerParametersEx
  1715. //
  1716. // Synopsis: ICategorizerParameters plus new methods to retrieve
  1717. //  requested attributes, register an interface which may be called
  1718. //  to get the list of GCs from dsaccess. Also a "Get" function for
  1719. //  the aforementioned interface.
  1720. //
  1721. // History:
  1722. // jstamerj 1999/07/08 14:24:56: Created
  1723. //
  1724. //-------------------------------------------------------------
  1725. [
  1726.     object,
  1727.     local,
  1728.     uuid(E962BA1F-3FB9-11d3-80D7-00C04FA322BA),
  1729.     helpstring("ICategorizerParametersEx Interface"),
  1730.     pointer_default(unique)
  1731. ]
  1732. interface ICategorizerParametersEx : ICategorizerParameters
  1733. {
  1734.     HRESULT GetDSParameterW(
  1735.         [in]  DWORD  dwDSParameter,
  1736.         [out] LPWSTR *ppszValue);
  1738.     HRESULT GetRequestedAttributes(
  1739.         [out] ICategorizerRequestedAttributes **ppIRequestedAttributes);
  1741.     HRESULT RegisterCatLdapConfigInterface(
  1742.         [out] ICategorizerLdapConfig *pICategorizerLdapConfig);
  1744.     HRESULT GetLdapConfigInterface(
  1745.         [out] ICategorizerLdapConfig **ppICatLdapConfigInfo);
  1746. };
  1748. //+------------------------------------------------------------
  1749. //
  1750. // Interface: ICategorizerRequestedAttributes
  1751. //
  1752. // Synopsis: Contains a read-only method to retrieve all the requested
  1753. //           attributes
  1754. //
  1755. // History:
  1756. // jstamerj 1999/07/08 14:24:56: Created
  1757. //
  1758. //-------------------------------------------------------------
  1759. [
  1760.     object,
  1761.     local,
  1762.     uuid(CB0924E0-357B-11d3-8328-00C04FA322BA),
  1763.     helpstring("ICategorizerRequestedAttributes Interface"),
  1764.     pointer_default(unique)
  1765. ]
  1766. interface ICategorizerRequestedAttributes : IUnknown
  1767. {
  1768.     HRESULT GetAllAttributes(
  1769.         [out] LPSTR **prgszAllAttributes);
  1771.     HRESULT GetAllAttributesW(
  1772.         [out] LPWSTR **prgszAllAttributes);
  1773. };
  1775. //+------------------------------------------------------------
  1776. //
  1777. // Interface: ICategorizerUTF8Attributes
  1778. //
  1779. // Synopsis: Methods to retrieve attributes as UTF8 strings
  1780. //
  1781. // History:
  1782. // jstamerj 1999/07/08 14:24:56: Created
  1783. //
  1784. //-------------------------------------------------------------
  1785. [
  1786.     object,
  1787.     local,
  1788.     uuid(BEBF931D-17E0-4ec8-BC1C-CC3286D72CB7),
  1789.     helpstring("ICategorizerUTF8Attributes Interface"),
  1790.     pointer_default(unique)
  1791. ]
  1792. interface ICategorizerUTF8Attributes : IUnknown
  1793. {
  1794.     [local] HRESULT BeginUTF8AttributeEnumeration(
  1795.         [in, unique] LPCSTR pszAttributeName,
  1796.         [in] PATTRIBUTE_ENUMERATOR penumerator);
  1798.     [local] HRESULT GetNextUTF8AttributeValue(
  1799.         [in] PATTRIBUTE_ENUMERATOR penumerator,
  1800.         [out] LPSTR *ppszAttributeValue);
  1802.     [local] HRESULT RewindUTF8AttributeEnumeration(
  1803.         [in] PATTRIBUTE_ENUMERATOR penumerator);
  1805.     [local] HRESULT EndUTF8AttributeEnumeration(
  1806.         [in] PATTRIBUTE_ENUMERATOR penumerator);
  1808.     [local] HRESULT CountUTF8AttributeValues(
  1809.         [in] PATTRIBUTE_ENUMERATOR penumerator,
  1810.         [out] DWORD *pdwCount);
  1812. };
  1814. //+------------------------------------------------------------
  1815. //
  1816. // Interface: ICategorizerLdapConfig
  1817. //
  1818. // Synopsis: Contains a function that may be queried for the GCs
  1819. //  on the machine as discovered by dsaccess (or as read from the
  1820. //  registry by dsaccess).
  1821. //
  1822. // History:
  1823. // gpulla created
  1824. //
  1825. //-------------------------------------------------------------
  1826. [
  1827.     object,
  1828.     local,
  1829.     uuid(27C1B2D3-1A28-4b90-BC0A-E52057D30712),
  1830.     helpstring("ICategorizerLdapConfig Interface"),
  1831.     pointer_default(unique)
  1832. ]
  1833. interface ICategorizerLdapConfig : IUnknown
  1834. {
  1835. HRESULT GetGCServers(
  1836. [out] IServersListInfo **pIServersListInfo);
  1838. };
  1840. //+------------------------------------------------------------
  1841. //
  1842. // Interface: IServersListInfo
  1843. //
  1844. // Synopsis: Interface to an object encapsulating the list of
  1845. //  GCs described above. Functions allow querying the number of
  1846. //  GCs and enumerating through the GCs.
  1847. //
  1848. // History:
  1849. // gpulla created
  1850. //
  1851. //-------------------------------------------------------------
  1852. [
  1853.     object,
  1854.     local,
  1855.     uuid(C54CEA94-E501-4f34-8704-F5881EA5CBF4),
  1856.     helpstring("IServersListInfo Interface"),
  1857.     pointer_default(unique)
  1858. ]
  1859. interface IServersListInfo : IUnknown
  1860. {
  1861. HRESULT GetNumGC(
  1862. [out] DWORD *dwGC);
  1864. HRESULT GetItem(
  1865. [in]  DWORD dwIdx,
  1866. [out] DWORD *dwPort,
  1867. [out] LPSTR *pszServerName);
  1868. };
  1871. cpp_quote("#endif //__SMTPEVENT_H__")