IVsTrackProjectDocumentsEvents3.HandsOffFiles(UInt32, Int32, String[]) 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
访问一组指定的文件，并请求此方法的所有实现程序释放这些文件上可能存在的任何锁。
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[] -> intPublic Function HandsOffFiles (grfRequiredAccess As UInteger, cFiles As Integer, rgpszMkDocuments As String()) As Integer参数
- grfRequiredAccess
- UInt32
中枚举中的一个值 __HANDSOFFMODE ，指示请求的访问类型。 这可用于优化实际需要释放的锁。
- cFiles
- Int32
中数组中的文件数 rgpszMkDocuments 。
- rgpszMkDocuments
- String[]
中如果此文件名数组有任何锁，则调用方希望释放这些锁。
返回
如果该方法成功，则它会返回 S_OK。 如果该方法失败，则会返回错误代码。
注解
COM 签名
从 ivstrackprojectdocumentsevents80
HRESULT HandsOffFiles(
[in] HANDSOFFMODE grfRequiredAccess,
[in] int cFiles,
[in, size_is(cFiles)] const LPCOLESTR rgpszMkDocuments[]
);
此方法是调用方法的结果 HandsOffFiles 。
通常在执行文件集合上的批处理之前调用此方法。 在返回之前，此方法应释放保存在文件上的任何锁。 如果此方法返回错误代码，则项目仍可能继续执行批处理。 应该实现此方法，以便尽快正确地释放所有锁定。