IVsTrackProjectDocumentsEvents3.HandsOnFiles(Int32, String[]) Method

Reference

Definition

Namespace:: Microsoft.VisualStudio.Shell.Interop

Assembly:: Microsoft.VisualStudio.Shell.Interop.8.0.dll

Assembly:: Microsoft.VisualStudio.Interop.dll

Package:: Microsoft.VisualStudio.Interop v17.12.40391

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.

Called when a project has completed operations on a set of files.

public:
 int HandsOnFiles(int cFiles, cli::array <System::String ^> ^ rgpszMkDocuments);

public:
 int HandsOnFiles(int cFiles, Platform::Array <Platform::String ^> ^ rgpszMkDocuments);

int HandsOnFiles(int cFiles, std::Array <std::wstring const &> const & rgpszMkDocuments);

public int HandsOnFiles (int cFiles, string[] rgpszMkDocuments);

abstract member HandsOnFiles : int * string[] -> int

Public Function HandsOnFiles (cFiles As Integer, rgpszMkDocuments As String()) As Integer

Parameters

cFiles: Int32

[in] Number of file names given in the rgpszMkDocuments array.

rgpszMkDocuments: String[]

[in] An array of file names.

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 HandsOnFiles(  
   [in] int cFiles,  
   [in, size_is(cFiles)] const LPCOLESTR rgpszMkDocuments[]  
);

This method is called as a result of a call to the HandsOnFiles method.

A project calls the HandsOffFiles method, which results in a call to the HandsOffFiles method. That call is the project telling all implementers of HandsOffFiles to release all requested locks on the specified files.

When the project is done with its processing of the files, it calls the HandsOnFiles method, which in turn calls the HandsOnFiles method, usually with the same array of file names as were passed to the HandsOffFiles method. This allows the implementer of the HandsOffFiles method to reestablish any locks it needs to on the files.

Note

It is possible that some or all of the file names in the array may have been renamed, moved, or deleted.

Applies to

Partilhar via