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] Если на этом массиве имен файлов стоят какие-либо блокировки, вызывающему объекту необходимо их снятие.
Возвращаемое значение
Если метод завершается успешно, возвращает значение S_OK. В противном случае функция возвращает код ошибки.
Комментарии
Подпись COM
Из ivstrackprojectdocumentsevents80. idl
HRESULT HandsOffFiles(
[in] HANDSOFFMODE grfRequiredAccess,
[in] int cFiles,
[in, size_is(cFiles)] const LPCOLESTR rgpszMkDocuments[]
);
Этот метод вызывается в результате вызова HandsOffFiles метода.
Этот метод обычно вызывается непосредственно перед выполнением пакетного процесса в коллекции файлов. Этот метод должен освободить все блокировки, удерживаемые в файлах, перед возвратом. Если этот метод возвращает код ошибки, проект по-прежнему может продолжать процесс пакетной обработки. Этот метод следует реализовать, чтобы правильно освобождать все блокировки как можно быстрее.