IVsTrackProjectDocumentsEvents3.HandsOffFiles(UInt32, Int32, String[]) Метод

Определение

Обращается к указанному набору файлов и просит все реализации этого метода освободить все блокировки, которые могут существовать для этих файлов.

public:
 int HandsOffFiles(System::UInt32 grfRequiredAccess, int cFiles, cli::array <System::String ^> ^ rgpszMkDocuments);
public:
 int HandsOffFiles(unsigned int grfRequiredAccess, int cFiles, Platform::Array <Platform::String ^> ^ rgpszMkDocuments);
int HandsOffFiles(unsigned int grfRequiredAccess, int cFiles, std::Array <std::wstring const &> const & rgpszMkDocuments);
public int HandsOffFiles (uint grfRequiredAccess, int cFiles, string[] rgpszMkDocuments);
abstract member HandsOffFiles : uint32 * int * string[] -> int
Public Function HandsOffFiles (grfRequiredAccess As UInteger, cFiles As Integer, rgpszMkDocuments As String()) As Integer

Параметры

grfRequiredAccess
UInt32

[in] Значение из перечисления __HANDSOFFMODE, указывающее запрошенный тип доступа. Это может использоваться, чтобы оптимизировать блокировки, которые фактически должны быть сняты.

cFiles
Int32

окне Число файлов в rgpszMkDocuments массиве.

rgpszMkDocuments
String[]

[in] Если на этом массиве имен файлов стоят какие-либо блокировки, вызывающему объекту необходимо их снятие.

Возвращаемое значение

Int32

Если метод завершается успешно, возвращает значение S_OK. В противном случае функция возвращает код ошибки.

Комментарии

Подпись COM

Из ivstrackprojectdocumentsevents80. idl

HRESULT HandsOffFiles(  
   [in] HANDSOFFMODE grfRequiredAccess,  
   [in] int cFiles,  
   [in, size_is(cFiles)] const LPCOLESTR rgpszMkDocuments[]  
);  

Этот метод вызывается в результате вызова HandsOffFiles метода.

Этот метод обычно вызывается непосредственно перед выполнением пакетного процесса в коллекции файлов. Этот метод должен освободить все блокировки, удерживаемые в файлах, перед возвратом. Если этот метод возвращает код ошибки, проект по-прежнему может продолжать процесс пакетной обработки. Этот метод следует реализовать, чтобы правильно освобождать все блокировки как можно быстрее.

Применяется к