16,551
社区成员
发帖
与我相关
我的任务
分享请发表友善的回复…
发表回复
fishboyzyf 2005-06-12
- 打赏
- 举报
up
fishboyzyf 2005-06-10
- 打赏
- 举报
up
hzh_net 2005-06-04
- 打赏
- 举报
--------------------------------------------------
IMAPIFormContainer::ResolveMultipleMessageClasses
The IMAPIFormContainer::ResolveMultipleMessageClasses method resolves a group of message classes to their forms within a form container and returns an array of form information objects for those forms.
Quick Info
See IMAPIFormContainer : IUnknown.
HRESULT ResolveMultipleMessageClasses (
LPSMESSAGECLASSARRAY pMsgClassArray,
ULONG ulFlags,
LPSMAPIFORMINFOARRAY FAR * ppfrminfoarray
);
Parameters
pMsgClassArray
[in] Pointer to an array containing the names of the message classes to resolve. Message class names are always ANSI strings, never Unicode.
ulFlags
[in] Bitmask of flags that controls how the message classes are resolved. The following flag can be set:
MAPIFORM_EXACTMATCH
Only message class strings that are an exact match should be resolved.
ppfrminfoarray
[out] Pointer to a pointer to an array of form information objects. If a client application passes NULL in the pMsgClassArray parameter, the ppfrminfoarray parameter contains form information objects for all forms in the container.
Return Values
S_OK
The call succeeded and has returned the expected value or values.
Remarks
Client applications call the IMAPIFormContainer::ResolveMultipleMessageClasses method to resolve a group of message classes to forms within a form container. The array of form information objects returned in the ppfrminfoarray parameter provides further access to each of the forms' properties.
Notes to Callers
To resolve a group of message classes to forms, pass in an array of message class names to be resolved. To force the resolution to be exact — that is, to prevent resolution to a superclass of the message class — the MAPIFORM_EXACTMATCH flag can be passed in the ulFlags parameter.
If a message class cannot be resolved to a form, NULL is returned for that message class in the form information array. Therefore, even if the method returns S_OK, do not assume that all message classes have been successfully resolved. Instead, check the values in the returned array.
See Also
IMAPIFormContainer::ResolveMessageClass
----------------------------
IMAPIFormContainer::CalcFormPropSet
The IMAPIFormContainer::CalcFormPropSet method returns an array of the properties used by all forms installed within a form container.
Quick Info
See IMAPIFormContainer : IUnknown.
HRESULT CalcFormPropSet(
ULONG ulFlags,
LPMAPIFORMPROPARRAY FAR * ppResults
);
Parameters
ulFlags
[in] Bitmask of flags that controls how the property array in the ppResults parameter is returned. The following flags can be set:
FORMPROPSET_INTERSECTION
The returned array contains the intersection of the forms' properties.
FORMPROPSET_UNION
The returned array contains the union of the forms' properties.
MAPI_UNICODE
The strings returned in the array are in Unicode format. If the MAPI_UNICODE flag is not set, the strings are in ANSI format.
ppResults
[out] Pointer to a pointer to the returned SMAPIFormPropArray structure. This structure contains all properties used by the installed forms.
Return Values
S_OK
The call succeeded and has returned the expected value or values.
MAPI_E_BAD_CHARWIDTH
Either the MAPI_UNICODE flag was set and the implementation does not support Unicode, or MAPI_UNICODE was not set and the implementation only supports Unicode.
Remarks
Client applications call the IMAPIFormContainer::CalcFormPropSet method to obtain an array of properties used by all forms installed within a form container. CalcFormPropSet works like the IMAPIFormMgr::CalcFormPropSet method, except that it operates on every form registered in a particular container.
Notes to Implementers
Form library providers that do not support Unicode strings should return MAPI_E_BAD_CHARWIDTH if MAPI_UNICODE is passed.
Notes to Callers
CalcFormPropSet either takes an intersection or a union of the forms' property sets, depending on the flag set in the ulFlags parameter, and it returns an SMAPIFormPropArray structure containing the resulting group of properties.
If a client passes the MAPI_UNICODE flag in ulFlags, all strings returned are Unicode.
See Also
IMAPIFormMgr::CalcFormPropSet, SMAPIFormPropArray
-----------------------
IMAPIFormContainer::GetDisplay
The IMAPIFormContainer::GetDisplay method returns the display name of a form container.
Quick Info
See IMAPIFormContainer : IUnknown.
HRESULT GetDisplay(
ULONG ulFlags,
LPTSTR FAR * pszDisplayName
);
Parameters
ulFlags
[in] Bitmask of flags that controls the type of the returned string. The following flag can be set:
MAPI_UNICODE
The returned string is in Unicode format. If the MAPI_UNICODE flag is not set, the string is in ANSI format.
pszDisplayName
[out] Pointer to a string containing the display name of the form container.
Return Values
S_OK
The call succeeded and has returned the expected value or values.
-------------------------
^_^
详见msdn
IMAPIFormContainer::ResolveMultipleMessageClasses
The IMAPIFormContainer::ResolveMultipleMessageClasses method resolves a group of message classes to their forms within a form container and returns an array of form information objects for those forms.
Quick Info
See IMAPIFormContainer : IUnknown.
HRESULT ResolveMultipleMessageClasses (
LPSMESSAGECLASSARRAY pMsgClassArray,
ULONG ulFlags,
LPSMAPIFORMINFOARRAY FAR * ppfrminfoarray
);
Parameters
pMsgClassArray
[in] Pointer to an array containing the names of the message classes to resolve. Message class names are always ANSI strings, never Unicode.
ulFlags
[in] Bitmask of flags that controls how the message classes are resolved. The following flag can be set:
MAPIFORM_EXACTMATCH
Only message class strings that are an exact match should be resolved.
ppfrminfoarray
[out] Pointer to a pointer to an array of form information objects. If a client application passes NULL in the pMsgClassArray parameter, the ppfrminfoarray parameter contains form information objects for all forms in the container.
Return Values
S_OK
The call succeeded and has returned the expected value or values.
Remarks
Client applications call the IMAPIFormContainer::ResolveMultipleMessageClasses method to resolve a group of message classes to forms within a form container. The array of form information objects returned in the ppfrminfoarray parameter provides further access to each of the forms' properties.
Notes to Callers
To resolve a group of message classes to forms, pass in an array of message class names to be resolved. To force the resolution to be exact — that is, to prevent resolution to a superclass of the message class — the MAPIFORM_EXACTMATCH flag can be passed in the ulFlags parameter.
If a message class cannot be resolved to a form, NULL is returned for that message class in the form information array. Therefore, even if the method returns S_OK, do not assume that all message classes have been successfully resolved. Instead, check the values in the returned array.
See Also
IMAPIFormContainer::ResolveMessageClass
----------------------------
IMAPIFormContainer::CalcFormPropSet
The IMAPIFormContainer::CalcFormPropSet method returns an array of the properties used by all forms installed within a form container.
Quick Info
See IMAPIFormContainer : IUnknown.
HRESULT CalcFormPropSet(
ULONG ulFlags,
LPMAPIFORMPROPARRAY FAR * ppResults
);
Parameters
ulFlags
[in] Bitmask of flags that controls how the property array in the ppResults parameter is returned. The following flags can be set:
FORMPROPSET_INTERSECTION
The returned array contains the intersection of the forms' properties.
FORMPROPSET_UNION
The returned array contains the union of the forms' properties.
MAPI_UNICODE
The strings returned in the array are in Unicode format. If the MAPI_UNICODE flag is not set, the strings are in ANSI format.
ppResults
[out] Pointer to a pointer to the returned SMAPIFormPropArray structure. This structure contains all properties used by the installed forms.
Return Values
S_OK
The call succeeded and has returned the expected value or values.
MAPI_E_BAD_CHARWIDTH
Either the MAPI_UNICODE flag was set and the implementation does not support Unicode, or MAPI_UNICODE was not set and the implementation only supports Unicode.
Remarks
Client applications call the IMAPIFormContainer::CalcFormPropSet method to obtain an array of properties used by all forms installed within a form container. CalcFormPropSet works like the IMAPIFormMgr::CalcFormPropSet method, except that it operates on every form registered in a particular container.
Notes to Implementers
Form library providers that do not support Unicode strings should return MAPI_E_BAD_CHARWIDTH if MAPI_UNICODE is passed.
Notes to Callers
CalcFormPropSet either takes an intersection or a union of the forms' property sets, depending on the flag set in the ulFlags parameter, and it returns an SMAPIFormPropArray structure containing the resulting group of properties.
If a client passes the MAPI_UNICODE flag in ulFlags, all strings returned are Unicode.
See Also
IMAPIFormMgr::CalcFormPropSet, SMAPIFormPropArray
-----------------------
IMAPIFormContainer::GetDisplay
The IMAPIFormContainer::GetDisplay method returns the display name of a form container.
Quick Info
See IMAPIFormContainer : IUnknown.
HRESULT GetDisplay(
ULONG ulFlags,
LPTSTR FAR * pszDisplayName
);
Parameters
ulFlags
[in] Bitmask of flags that controls the type of the returned string. The following flag can be set:
MAPI_UNICODE
The returned string is in Unicode format. If the MAPI_UNICODE flag is not set, the string is in ANSI format.
pszDisplayName
[out] Pointer to a string containing the display name of the form container.
Return Values
S_OK
The call succeeded and has returned the expected value or values.
-------------------------
^_^
详见msdn
hzh_net 2005-06-04
- 打赏
- 举报
Platform SDK: MAPI
IMAPIFormContainer : IUnknown
The IMAPIFormContainer interface manages forms within form libraries. This interface is used to create application-specific form libraries.
Quick Info
Header file: MAPIFORM.H
Exposed by: Form container objects
Implemented by: Form library providers
Called by: Client applications
Interface identifier: IID_IMAPIFormContainer
Pointer type: LPMAPIFORMCONTAINER
Vtable Order
InstallForm Installs a form into a form container.
RemoveForm Removes a particular form from a form container.
ResolveMessageClass Resolves a message class to its form within a form container and returns a form information object for that form.
ResolveMultipleMessageClasses Resolves a group of message classes to their forms within a form container and returns an array of form information objects for those forms.
CalcFormPropSet Returns an array of the properties used by all forms installed within a form container.
GetDisplay Returns the display name of a form container.
----------------------------------------------------
IMAPIFormContainer::InstallForm
The IMAPIFormContainer::InstallForm method installs a form into a form library.
Quick Info
See IMAPIFormContainer : IUnknown.
HRESULT InstallForm(
ULONG ulUIParam,
ULONG ulFlags,
LPCTSTR szCfgPathName
);
Parameters
ulUIParam
[in] Handle of the parent window for any dialog boxes or windows this method displays. The ulUIParam parameter is ignored unless the client application sets the MAPI_DIALOG flag in the ulFlags parameter. The ulUIParam parameter can be NULL if MAPI_DIALOG is not also passed.
ulFlags
[in] Bitmask of flags that controls the installation of the form. The following flags can be set:
MAPI_DIALOG
Displays a dialog box to provide progress information or prompt the user for additional information. If this flag is not set, no dialog box is displayed.
MAPI_UNICODE
The passed-in strings are in Unicode format. If the MAPI_UNICODE flag is not set, the strings are in ANSI format.
MAPIFORM_INSTALL_OVERWRITEONCONFLICT
If another form already exists that handles the message class handled by this form, then replace the existing form with this one. This flag is ignored if the MAPI_DIALOG flag is also present.
szCfgPathName
[in] Path to the form's configuration file.
Return Values
S_OK
The call succeeded and has returned the expected value or values.
MAPI_E_EXTENDED_ERROR
An implementation error occurred; to get the MAPIERROR structure associated with the error, call the IMAPIFormContainer::GetLastError method.
MAPI_E_USER_CANCEL
The user canceled the installation of the form, typically by clicking the Cancel button in a dialog box.
Notes to Implementers
Form library providers should fill in a MAPIERROR structure and return MAPI_E_EXTENDED_ERROR if any of the following conditions occur:
The configuration file is not found.
The configuration file is not readable.
The configuration file is invalid.
Notes to Callers
Client applications call the IMAPIFormContainer::InstallForm method to install a form into a specific form container. The szCfgPathName parameter must contain the path of a form configuration file — that is, a file with the .CFG extension — that describes the form and its implementation. The flags in the ulFlags parameter specify:
That a user interface enabling the user installing the form to specify details of installation is displayed, if the MAPI_DIALOG flag is set.
That any previous form for the same message class is replaced with the form being installed, if the MAPIFORM_INSTALL_OVERWRITEONCONFLICT flag is set. Otherwise, the form installation is merged with the current form description, if one exists.
That MAPIFORM_INSTALL_OVERWRITEONCONFLICT is ignored when MAPI_DIALOG is present.
That the absence of MAPIFORM_INSTALL_OVERWRITEONCONFLICT in the flag set means that a merge will be done. Any new platforms in the .CFG file not currently present in the form description will be installed and no other changes will take place.
That the path to the form configuration file is a Unicode string, if the MAPI_UNICODE flag is set.
Clients should call IMAPIFormContainer::GetLastError if InstallForm returns MAPI_E_EXTENDED_ERROR and should check the returned MAPIERROR structure to determine the condition causing the error.
------------------------------------
IMAPIFormContainer::RemoveForm
The IMAPIFormContainer::RemoveForm method removes a particular form from a form container.
Quick Info
See IMAPIFormContainer : IUnknown.
HRESULT RemoveForm(
LPCSTR szMessageClass
);
Parameters
szMessageClass
[in] String naming the message class of the form to be removed from the form container. Message class names are always ANSI strings, never Unicode.
Return Values
S_OK
The call succeeded and has returned the expected value or values.
MAPI_E_NOT_FOUND
The message class passed in the szMessageClass parameter does not match the message class of any form in the form container.
-----------------------------
IMAPIFormContainer::ResolveMessageClass
The IMAPIFormContainer::ResolveMessageClass method resolves a message class to its form within a form container and returns a form information object for that form.
Quick Info
See IMAPIFormContainer : IUnknown.
HRESULT ResolveMessageClass(
LPCSTR szMessageClass,
ULONG ulFlags,
LPMAPIFORMINFO FAR * ppforminfo
);
Parameters
szMessageClass
[in] String naming the message class being resolved. Message class names are always ANSI strings, never Unicode.
ulFlags
[in] Bitmask of flags that controls how the message class is resolved. The following flag can be set:
MAPIFORM_EXACTMATCH
Only message class strings that are an exact match should be resolved.
ppforminfo
[out] Pointer to a pointer to the returned form information object.
Return Values
S_OK
The call succeeded and has returned the expected value or values.
MAPI_E_NOT_FOUND
The message class passed in the szMessageClass parameter does not match the message class for any form in the form container.
Remarks
Client applications call the IMAPIFormContainer::ResolveMessageClass method to resolve a message class to a form within a form container. The form information object returned in the ppforminfo parameter provides further access to the properties of the form with the given message class.
Notes to Callers
To resolve a message class to a form, pass in the name of the message class to be resolved, for example IPM.HelpDesk.Software. To force the resolution to be exact — that is, to prevent resolution to a superclass of the message class — the MAPIFORM_EXACTMATCH flag can be passed in the ulFlags parameter.
The class identifier for the resolved message class is returned as part of the form information object. Do not assume that the class identifier exists in the OLE library until after calling either the IMAPIFormMgr::PrepareForm method or the IMAPIFormMgr::CreateForm method.
See Also
IMAPIFormInfo : IMAPIProp, IMAPIFormMgr::CreateForm, IMAPIFormMgr::PrepareForm
IMAPIFormContainer : IUnknown
The IMAPIFormContainer interface manages forms within form libraries. This interface is used to create application-specific form libraries.
Quick Info
Header file: MAPIFORM.H
Exposed by: Form container objects
Implemented by: Form library providers
Called by: Client applications
Interface identifier: IID_IMAPIFormContainer
Pointer type: LPMAPIFORMCONTAINER
Vtable Order
InstallForm Installs a form into a form container.
RemoveForm Removes a particular form from a form container.
ResolveMessageClass Resolves a message class to its form within a form container and returns a form information object for that form.
ResolveMultipleMessageClasses Resolves a group of message classes to their forms within a form container and returns an array of form information objects for those forms.
CalcFormPropSet Returns an array of the properties used by all forms installed within a form container.
GetDisplay Returns the display name of a form container.
----------------------------------------------------
IMAPIFormContainer::InstallForm
The IMAPIFormContainer::InstallForm method installs a form into a form library.
Quick Info
See IMAPIFormContainer : IUnknown.
HRESULT InstallForm(
ULONG ulUIParam,
ULONG ulFlags,
LPCTSTR szCfgPathName
);
Parameters
ulUIParam
[in] Handle of the parent window for any dialog boxes or windows this method displays. The ulUIParam parameter is ignored unless the client application sets the MAPI_DIALOG flag in the ulFlags parameter. The ulUIParam parameter can be NULL if MAPI_DIALOG is not also passed.
ulFlags
[in] Bitmask of flags that controls the installation of the form. The following flags can be set:
MAPI_DIALOG
Displays a dialog box to provide progress information or prompt the user for additional information. If this flag is not set, no dialog box is displayed.
MAPI_UNICODE
The passed-in strings are in Unicode format. If the MAPI_UNICODE flag is not set, the strings are in ANSI format.
MAPIFORM_INSTALL_OVERWRITEONCONFLICT
If another form already exists that handles the message class handled by this form, then replace the existing form with this one. This flag is ignored if the MAPI_DIALOG flag is also present.
szCfgPathName
[in] Path to the form's configuration file.
Return Values
S_OK
The call succeeded and has returned the expected value or values.
MAPI_E_EXTENDED_ERROR
An implementation error occurred; to get the MAPIERROR structure associated with the error, call the IMAPIFormContainer::GetLastError method.
MAPI_E_USER_CANCEL
The user canceled the installation of the form, typically by clicking the Cancel button in a dialog box.
Notes to Implementers
Form library providers should fill in a MAPIERROR structure and return MAPI_E_EXTENDED_ERROR if any of the following conditions occur:
The configuration file is not found.
The configuration file is not readable.
The configuration file is invalid.
Notes to Callers
Client applications call the IMAPIFormContainer::InstallForm method to install a form into a specific form container. The szCfgPathName parameter must contain the path of a form configuration file — that is, a file with the .CFG extension — that describes the form and its implementation. The flags in the ulFlags parameter specify:
That a user interface enabling the user installing the form to specify details of installation is displayed, if the MAPI_DIALOG flag is set.
That any previous form for the same message class is replaced with the form being installed, if the MAPIFORM_INSTALL_OVERWRITEONCONFLICT flag is set. Otherwise, the form installation is merged with the current form description, if one exists.
That MAPIFORM_INSTALL_OVERWRITEONCONFLICT is ignored when MAPI_DIALOG is present.
That the absence of MAPIFORM_INSTALL_OVERWRITEONCONFLICT in the flag set means that a merge will be done. Any new platforms in the .CFG file not currently present in the form description will be installed and no other changes will take place.
That the path to the form configuration file is a Unicode string, if the MAPI_UNICODE flag is set.
Clients should call IMAPIFormContainer::GetLastError if InstallForm returns MAPI_E_EXTENDED_ERROR and should check the returned MAPIERROR structure to determine the condition causing the error.
------------------------------------
IMAPIFormContainer::RemoveForm
The IMAPIFormContainer::RemoveForm method removes a particular form from a form container.
Quick Info
See IMAPIFormContainer : IUnknown.
HRESULT RemoveForm(
LPCSTR szMessageClass
);
Parameters
szMessageClass
[in] String naming the message class of the form to be removed from the form container. Message class names are always ANSI strings, never Unicode.
Return Values
S_OK
The call succeeded and has returned the expected value or values.
MAPI_E_NOT_FOUND
The message class passed in the szMessageClass parameter does not match the message class of any form in the form container.
-----------------------------
IMAPIFormContainer::ResolveMessageClass
The IMAPIFormContainer::ResolveMessageClass method resolves a message class to its form within a form container and returns a form information object for that form.
Quick Info
See IMAPIFormContainer : IUnknown.
HRESULT ResolveMessageClass(
LPCSTR szMessageClass,
ULONG ulFlags,
LPMAPIFORMINFO FAR * ppforminfo
);
Parameters
szMessageClass
[in] String naming the message class being resolved. Message class names are always ANSI strings, never Unicode.
ulFlags
[in] Bitmask of flags that controls how the message class is resolved. The following flag can be set:
MAPIFORM_EXACTMATCH
Only message class strings that are an exact match should be resolved.
ppforminfo
[out] Pointer to a pointer to the returned form information object.
Return Values
S_OK
The call succeeded and has returned the expected value or values.
MAPI_E_NOT_FOUND
The message class passed in the szMessageClass parameter does not match the message class for any form in the form container.
Remarks
Client applications call the IMAPIFormContainer::ResolveMessageClass method to resolve a message class to a form within a form container. The form information object returned in the ppforminfo parameter provides further access to the properties of the form with the given message class.
Notes to Callers
To resolve a message class to a form, pass in the name of the message class to be resolved, for example IPM.HelpDesk.Software. To force the resolution to be exact — that is, to prevent resolution to a superclass of the message class — the MAPIFORM_EXACTMATCH flag can be passed in the ulFlags parameter.
The class identifier for the resolved message class is returned as part of the form information object. Do not assume that the class identifier exists in the OLE library until after calling either the IMAPIFormMgr::PrepareForm method or the IMAPIFormMgr::CreateForm method.
See Also
IMAPIFormInfo : IMAPIProp, IMAPIFormMgr::CreateForm, IMAPIFormMgr::PrepareForm
hzh_net 2005-06-04
- 打赏
- 举报
form library
A form container as seen through the user interface (UI). MAPI distinguishes several types of form library, including the application form library, folder form library, and personal form library.
form library provider
A MAPI service provider object that manages one or more form libraries. Like most service providers it is a dynamic-link library (DLL). Form library providers implement the IMAPIFormContainer : IUnknown, IMAPIFormInfo : IMAPIProp, and IMAPIFormMgr : IUnknown interfaces. See also form.
A form container as seen through the user interface (UI). MAPI distinguishes several types of form library, including the application form library, folder form library, and personal form library.
form library provider
A MAPI service provider object that manages one or more form libraries. Like most service providers it is a dynamic-link library (DLL). Form library providers implement the IMAPIFormContainer : IUnknown, IMAPIFormInfo : IMAPIProp, and IMAPIFormMgr : IUnknown interfaces. See also form.
fishboyzyf 2005-06-04
- 打赏
- 举报
我的泡泡是fishboyzyf@163.com,msn:fishboyzyf@hotmail.com
各位帮忙啊
各位帮忙啊
fishboyzyf 2005-06-04
- 打赏
- 举报
我的泡泡是fishboyzyf@163.com,msn:fishboyzyf@hotmail.com
各位帮忙啊
各位帮忙啊
fishboyzyf 2005-06-03
- 打赏
- 举报
自己定
friendzj 2005-06-02
- 打赏
- 举报
帮你顶了~
fishboyzyf 2005-06-02
- 打赏
- 举报
我的泡泡是fishboyzyf@163.com,msn:fishboyzyf@hotmail.com
各位帮忙啊
各位帮忙啊
fishboyzyf 2005-06-02
- 打赏
- 举报
up
fishboyzyf 2005-06-02
- 打赏
- 举报
mark
xqk 2005-06-02
- 打赏
- 举报
mark
