IVsFileChangeEx.SyncFile Method
Forces change events to be sent. Used in conjunction with IgnoreFile to make file changes but not receive notification.
Namespace: Microsoft.VisualStudio.Shell.Interop
Assembly: Microsoft.VisualStudio.Shell.Interop (in Microsoft.VisualStudio.Shell.Interop.dll)
Syntax
'宣言
Function SyncFile ( _
pszMkDocument As String _
) As Integer
'使用
Dim instance As IVsFileChangeEx
Dim pszMkDocument As String
Dim returnValue As Integer
returnValue = instance.SyncFile(pszMkDocument)
int SyncFile(
string pszMkDocument
)
int SyncFile(
[InAttribute] String^ pszMkDocument
)
function SyncFile(
pszMkDocument : String
) : int
Parameters
pszMkDocument
Type: System.String[in] String form of the moniker identifier of the document in the project system. In the case of documents that are files, this is always the path to the file.
Return Value
Type: System.Int32
If the method succeeds, it returns S_OK. If it fails, it returns an error code.
Remarks
COM Signature
From vsshell.idl:
HRESULT IVsFileChangeEx::SyncFile(
[in] LPCOLESTR pszMkDocument
);
Use this method in conjunction with IgnoreFile Method if you are making a change to the file and do not want to receive the change notification. This is shown in the following example:
pFC->IgnoreFile(dwConnect, "MyFile.cpp", TRUE);
SaveFile("MyFile.cpp");
pFC->SyncFile("MyFile.cpp")
// Forces the change events to be sent. This ensures the event will not be sent (asynchronously) to you after you stop ignoring the file.
pFC->IgnoreFile(dwConnect, "MyFile.cpp", FALSE)
// This indicates you are listening to the events again.
Permissions
- Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.