When processing certain credentials messages such as KMSG_CRED_PASSWORD, KMSG_CRED_NEW_CREDS, KMSG_CRED_RENEW_CREDS, a pointer to a khui_new_creds structure will be passed in to the message handler. If the handler of the message needs to add one or more credentials types as participants of the operation, the handler will need to call khui_cw_add_type() and specify a khui_new_creds_by_type structure.
Note that the memory address passed in to the call to khui_cw_add_type() will not be copied. Therefore, the block of memory should remain as-is for the lifetime of the khui_new_creds structure or until it is removed with a call to khui_cw_del_type().
Some of the credentials messages that require specifying a khui_new_creds_by_type structure require providing a user-interface. In these cases, the fields marked for providing a UI may be required to hold valid values. If the message does not require providing a UI, these fields will be ignored.
The identifier of the credentials type. This is a credentials type identifier allocated with a call to kcdb_credtype_register().
credentials types that this credential type depends on. Each element defines a credentials type identifier that this type depends on for this operation. The number of valid values in this array should be specified in the n_type_deps field.
Number of dependencies listed above. Should be between 0 and KHUI_MAX_TYPE_DEPS. Specify 0 if there are no dependencies.
The requested ordinal. The UI would attempt to place this panel at the reqested order in the list of panels. Set to -1 if the order does not matter. Once the dialog is activated this field will be updated to reflect the actual ordinal of the panel.
Name of the panel (localized, optional). If NULL, the localized name of the credentials type is used. Only used if providing a user-interface.
Icon for the panel (optional). Only used if providing a user-interface.
Tooltip for the panel (localized, optional). If NULL, no tooltip will be assigned for the panel. Only used if providing a user-interface.
Handle to the module containing the dialog resource. Only used if providing a user-interface.
The dialog resource. Only used if providing a user-interface.
The dialog procedure. Only used if providing a user-interface.
The dialog window. Once the dialog panel is created, a handle to the panel will be assigned here. Note that the handle is assigned after a successful call to CreateDialogParam and hence would not be available when handling the WM_INITDIALOG message from the dialog procedure. Only used of providing a user-interface.
Internal use. Do not set
A brief description of the current state of this cred type. (localized, optional). Only used if providing a user-interface. If this field is non-NULL, then it should point to a NULL terminated string that does not exceed KHUI_MAXCCH_LONG_DESC characters in length including the terminating NULL.
auxilliary field. For use by the plug-in.
Generated on Fri Aug 3 08:27:15 2007 for Network Identity Manager by Doxygen 1.5.2
© 2004-2007 Massachusetts Institute of Technology.
© 2005-2007 Secure Endpoints Inc.