Directory Services

CQAddFormsProc

The CQAddFormsProc callback function is called by a query form extension to add a form to the query dialog box. A pointer to this function is supplied to the query form extension in the pAddFormsProc parameter of the IQueryForm::AddForms method. CQAddFormsProc is a placeholder for the query handler-defined function name.

HRESULT CALLBACK CQAddFormsProc(
  LPARAM lParam,
  LPCQFORM pForm
);

Parameters

lParam
Contains a 32-bit value defined by the query handler. This value is passed to the query form extension as the lParam parameter in the IQueryForm::AddForms call.
pForm
Pointer to a CQFORM structure that defines the form to add.

Return Values

Returns an HRESULT value that indicates the success, or failure, of the form add operation. The following table lists possible return values.
Return Code Description
S_OK The form was added successfully.
E_INVALIDARG One or more parameters are invalid.
E_OUTOFMEMORY A memory allocation failure occurred.
E_FAIL An unspecified error occurred.

Requirements

Client: Included in Windows XP and Windows 2000 Professional.
Server: Included in Windows Server 2003 and Windows 2000 Server.
Header: Declared in Cmnquery.h.

See Also

IQueryForm::AddForms, CQFORM