HrCfgAdvise

The HrCfgAdvise function monitors an extension data section.

Quick Info

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