IVsRunningDocumentTable2.QueryCloseRunningDocument Method

Article
04/29/2015

Closes the specified document, with possible confirmation, if it is open in an incompatible editor.

Namespace: Microsoft.VisualStudio.Shell.Interop
Assembly: Microsoft.VisualStudio.Shell.Interop.8.0 (in Microsoft.VisualStudio.Shell.Interop.8.0.dll)

Syntax

'Declaration
Function QueryCloseRunningDocument ( _
    pszMkDocument As String, _
    <OutAttribute> ByRef pfFoundAndClosed As Integer _
) As Integer

int QueryCloseRunningDocument(
    string pszMkDocument,
    out int pfFoundAndClosed
)

int QueryCloseRunningDocument(
    [InAttribute] String^ pszMkDocument, 
    [OutAttribute] int% pfFoundAndClosed
)

abstract QueryCloseRunningDocument : 
        pszMkDocument:string * 
        pfFoundAndClosed:int byref -> int

function QueryCloseRunningDocument(
    pszMkDocument : String, 
    pfFoundAndClosed : int
) : int

Parameters

pszMkDocument
Type: String

[in] The path to the document to close.

pfFoundAndClosed
Type: Int32%

[out] Returns non-zero (TRUE) if the document was found and closed; otherwise, returns zero (FALSE). See Remarks.

Return Value

Type: Int32
If the method succeeds, it returns S_OK. If it fails, it returns an error code.

Remarks

COM Signature

From vsshell80.idl:

HRESULT QueryCloseRunningDocument(
   [in] LPCOLESTR pszMkDocument,
   [out] BOOL *pfFoundAndClosed
);

This method is called after a document has been opened in an editor that turns out to be incompatible with the document. This method closes the document automatically unless certain conditions exist, in which case, the user is prompted to close the document. The following list indicates what happens when this method is called.

If the document is not in the running document table (RDT), then this method sets the pfFoundAndClosed parameter to zero (FALSE) and returns S_OK.
If the document is in the RDT and has only read locks, then the document is automatically closed.
If the document is in the RDT and has edit locks, then the user is prompted to close the file.
If the user chooses not to close the document, then this method sets the pfFoundAndClosed parameter to zero (FALSE) and returns OLE_E_PROMPTSAVECANCELLED.
If the document is actually closed, then this method sets the pfFoundAndClosed parameter to non-zero (TRUE) and returns S_OK.

.NET Framework Security

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.

Partager via