HrCfgAdvise

The HrCfgAdvise function monitors an extension data section.

Quick Info

Header file: EDKCFG.H
Library: EDKCFG.LIB 

HRESULT HrCfgAdvise(
  LPADVISEOBJ lpAdviseObj,        
  LPSTR lpszSection,              
  LPADVISECALLBACK lpfnCallback,  
  LPVOID lpvUserContext           
);

Parameters

lpAdviseObj
Input parameter. Points to an ADVISEOBJ structure containing an advise object.
lpszSection
Input parameter. Points to the name of the extension data section.
lpfnCallback
Input parameter. Points to an ADVISECALLBACK function to call on changes.
lpvUserContext
Input parameter. Points to a user-defined context.

Return Values

See Return Values.

Remarks

When the extension data changes, Microsoft Exchange Server calls the callback routine specified in the ADVISECALLBACK function where the lpfnCallback parameter points. The callback routine is called by the HrCfgAdvise function to initialize the extension data values.

Note You must first call the HrCfgCreateAdviseObj function to obtain the pointer to the ADVISEOBJ structure for the lpAdviseObj parameter.

For more information on this function, see Using the Configuration Functions.

See Also

HrCfgDestroyAdviseObj, HrCfgPollAdviseObj, HrCfgUnadvise