IVsTrackProjectDocumentsEvents3.OnEndQueryBatch(Int32) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Determines whether it is okay to proceed with the actual batch operation after successful completion of a batch query process.
public:
int OnEndQueryBatch([Runtime::InteropServices::Out] int % pfActionOK);int OnEndQueryBatch([Runtime::InteropServices::Out] int & pfActionOK);public int OnEndQueryBatch (out int pfActionOK);abstract member OnEndQueryBatch : int -> intPublic Function OnEndQueryBatch (ByRef pfActionOK As Integer) As IntegerParameters
- pfActionOK
- Int32
[out] Returns nonzero if it is okay to continue with the proposed batch process. Returns zero if the proposed batch process should not proceed.
Returns
If the method succeeds, it returns S_OK. If it fails, it returns an error code.
Remarks
COM Signature
From ivstrackprojectdocumentsevents80.idl
HRESULT OnEndQueryBatch(
[out, retval] BOOL *pfActionOK
);
This method is called as a result of a call to the EndQueryBatch method.
If any query in a project's batch query process results in an error, the project calls the CancelQueryBatch method, which in turn calls the OnCancelQueryBatch method. However, if all queries succeed, the project calls the OnEndQueryBatch method. If this method has any reason to cancel any subsequent batch operation, it signals the caller by returning 0 for pfActionOK. This could be a result of presenting a dialog box (in which the user canceled the batch operation) or some internal determination as a result of all the queries made.
For every call to this method, there must have been a previous call to the OnBeginQueryBatch method.