IVsRunningDocumentTable2.QueryCloseRunningDocument(String, Int32) Yöntem

Tanım

Uyumsuz bir düzenleyicide açıksa, belirtilen belgeyi olası onay ile kapatır.

public:
 int QueryCloseRunningDocument(System::String ^ pszMkDocument, [Runtime::InteropServices::Out] int % pfFoundAndClosed);
int QueryCloseRunningDocument(std::wstring const & pszMkDocument, [Runtime::InteropServices::Out] int & pfFoundAndClosed);
public int QueryCloseRunningDocument (string pszMkDocument, out int pfFoundAndClosed);
abstract member QueryCloseRunningDocument : string * int -> int
Public Function QueryCloseRunningDocument (pszMkDocument As String, ByRef pfFoundAndClosed As Integer) As Integer

Parametreler

pszMkDocument
String

'ndaki Kapatılacak belgenin yolu.

pfFoundAndClosed
Int32

dışı TRUEBelge bulunursa ve kapalıysa sıfır olmayan () döndürür; Aksi takdirde, sıfır ( FALSE ) döndürür. Bkz. açıklamalar.

Döndürülenler

Int32

Yöntem başarılı olursa, döndürür S_OK . Başarısız olursa, bir hata kodu döndürür.

Açıklamalar

COM Imzası

Vsshell80. IDL adresinden:

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

Bu yöntem, belge ile uyumlu olmayan bir düzenleyicide bir belge açıldıktan sonra çağrılır. Bu yöntem, belirli koşullar mevcut olmadığı takdirde belgeyi otomatik olarak kapatır, bu durumda kullanıcıdan belgeyi kapatması istenir. Aşağıdaki liste, bu yöntem çağrıldığında ne olacağını gösterir.

  • Belge, çalışan belge tablosunda (RDT) yoksa, bu yöntem pfFoundAndClosed parametreyi sıfır () olarak ayarlar FALSE ve döndürür S_OK .

  • Belge RDT 'de ise ve yalnızca okuma kilitleri varsa, belge otomatik olarak kapatılır.

  • Belge RDT 'de ise ve düzenleme kilitleri varsa, kullanıcıdan dosyayı kapatması istenir.

  • Kullanıcı belgeyi Kapatmayabilir ' i seçerse, bu yöntem pfFoundAndClosed parametreyi sıfır () olarak ayarlar FALSE ve döndürür OLE_E_PROMPTSAVECANCELLED .

  • Belge gerçekten kapalıysa, bu yöntem pfFoundAndClosed parametreyi sıfır olmayan () olarak ayarlar TRUE ve döndürür S_OK .

Şunlara uygulanır