IVsTrackProjectDocumentsEvents3.HandsOffFiles(UInt32, Int32, String[]) Methode

Definition

Greift auf einen angegebenen Satz von Dateien zu und fordert alle Implementierungen dieser Methode auf, alle Sperren freizugeben, die für diese Dateien vorhanden sind.

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

Parameter

grfRequiredAccess
UInt32

[in] Ein Wert aus der __HANDSOFFMODE-Enumeration, die den angeforderten Zugriffstyp angibt. Dies kann verwendet werden, um die Sperren zu optimieren, die momentan freigegeben werden müssen.

cFiles
Int32

in Die Anzahl der Dateien im rgpszMkDocuments Array.

rgpszMkDocuments
String[]

[in] Wenn dieses Array von Dateinamen Sperren enthält, will der Aufrufer, dass sie freigegeben werden.

Gibt zurück

Int32

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Bei einem Fehler wird ein Fehlercode zurückgegeben.

Hinweise

COM-Signatur

Aus ivstrackprojectdocumentsevents80. idl

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

Diese Methode wird als Ergebnis eines Aufrufs der-Methode aufgerufen HandsOffFiles .

Diese Methode wird in der Regel aufgerufen, kurz bevor ein Batch Prozess für eine Auflistung von Dateien ausgeführt wird. Diese Methode sollte alle Sperren für die Dateien freigeben, bevor Sie zurückgegeben werden. Wenn diese Methode einen Fehlercode zurückgibt, wird das Projekt möglicherweise weiterhin mit dem Batch Prozess fortgesetzt. Diese Methode sollte implementiert werden, um alle Sperren so schnell wie möglich freizugeben.

Gilt für