IVsTrackProjectDocumentsEvents3.OnEndQueryBatch(Int32) Method

Definition

Namespace:

Microsoft.VisualStudio.Shell.Interop

Assembly:

Microsoft.VisualStudio.Interop.dll

Package:

Microsoft.VisualStudio.Interop v17.12.40391

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 -> int

Public Function OnEndQueryBatch (ByRef pfActionOK As Integer) As Integer

Parameters

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

Int32

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.