Udostępnij za pośrednictwem

Metoda IVsRunningDocumentTable2.QueryCloseRunningDocument — (String, Int32)

  • Artykuł

 

Zamyka określony dokument z możliwe potwierdzenie, jeśli jest on otwarty w niezgodnym edytorze.

Przestrzeń nazw:   Microsoft.VisualStudio.Shell.Interop
Zestaw:  Microsoft.VisualStudio.Shell.Interop.8.0 (w Microsoft.VisualStudio.Shell.Interop.8.0.dll)

Składnia

int QueryCloseRunningDocument(
    string pszMkDocument,
    out int pfFoundAndClosed
)

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

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

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

Parametry

  • pszMkDocument
    Type: System.String

    [in] Ścieżka do dokumentu, aby zamknąć.

  • pfFoundAndClosed
    Type: System.Int32

    [out] Zwraca wartość niezerową (TRUE) Jeśli dokument został znaleziony i zamknięte; w przeciwnym razie zwraca wartość zero (FALSE). Zobacz uwagi.

Wartość zwracana

Type: System.Int32

Jeśli metoda zakończy się pomyślnie, zwraca S_OK. Jeśli nie, zwraca kod błędu.

Uwagi

Podpis COM

Z vsshell80.idl:

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

Ta metoda jest wywoływana po otwarciu dokumentu w edytorze okaże się niezgodny z dokumentu. Ta metoda zamyka automatycznie dokument, chyba że pewnych warunków, w takim przypadku użytkownik jest monitowany o Zamknij dokument. Poniższa lista wskazuje, co się dzieje, gdy ta metoda jest wywoływana.

  • Jeśli dokument nie znajduje się w tabeli uruchomionego dokumentu (Normalizacją), wówczas ta metoda ustawia pfFoundAndClosed parametru na wartość zero (FALSE) i zwraca S_OK.

  • Jeśli dokument jest Normalizacją i ma tylko do odczytu blokad, dokumentu automatycznie jest zamknięty.

  • Jeśli dokument ma Normalizacją i edycji blokad, użytkownik jest monitowany o Zamknij plik.

  • Jeśli użytkownik wybierze opcję Zamknij dokument, a następnie ustawia tę metodę pfFoundAndClosed parametru na wartość zero (FALSE) i zwraca OLE_E_PROMPTSAVECANCELLED.

  • Jeśli faktycznie zamknięciu dokumentu, a następnie ustawia tę metodę pfFoundAndClosed parametr różna od zera (TRUE) i zwraca S_OK.

Zobacz też

Interfejs IVsRunningDocumentTable2
Przestrzeń nazw Microsoft.VisualStudio.Shell.Interop

Powrót do początku