IVsRunningDocTableEvents4.OnBeforeFirstDocumentLock(IVsHierarchy, UInt32, String) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Chamado antes de um documento ser bloqueado na tabela de documentos em execução (RDT) pela primeira vez.
public:
int OnBeforeFirstDocumentLock(Microsoft::VisualStudio::Shell::Interop::IVsHierarchy ^ pHier, System::UInt32 itemid, System::String ^ pszMkDocument);
public:
int OnBeforeFirstDocumentLock(Microsoft::VisualStudio::Shell::Interop::IVsHierarchy ^ pHier, unsigned int itemid, Platform::String ^ pszMkDocument);
int OnBeforeFirstDocumentLock(Microsoft::VisualStudio::Shell::Interop::IVsHierarchy const & pHier, unsigned int itemid, std::wstring const & pszMkDocument);
public int OnBeforeFirstDocumentLock (Microsoft.VisualStudio.Shell.Interop.IVsHierarchy pHier, uint itemid, string pszMkDocument);
abstract member OnBeforeFirstDocumentLock : Microsoft.VisualStudio.Shell.Interop.IVsHierarchy * uint32 * string -> int
Public Function OnBeforeFirstDocumentLock (pHier As IVsHierarchy, itemid As UInteger, pszMkDocument As String) As Integer
Parâmetros
- pHier
- IVsHierarchy
no O IVsHierarchy objeto que possui o documento prestes a ser bloqueado.
- itemid
- UInt32
no A ID do item na hierarquia. Esse é um identificador exclusivo ou pode ser um dos seguintes valores: VSITEMID_NIL , VSITEMID_ROOT ou VSITEMID_SELECTION .
- pszMkDocument
- String
no O caminho para o documento a ser bloqueado.
Retornos
Se o método for bem-sucedido, retornará S_OK. Se falhar, retornará um código de erro.
Comentários
Assinatura COM
De vsshell80. idl:
[C++]
HRESULT IVsRunningDocTableEvents4::OnBeforeFirstDocumentLock(
[in] IVsHierarchy* pHier,
[in] VSITEMID itemid
);
Esse evento pode ser usado para garantir que o documento prestes a ser bloqueado esteja realmente presente no disco. Por exemplo, esse evento pode conceder ao controle do código-fonte a oportunidade de baixar o arquivo especificado do banco de dados de controle do código-fonte antes que ele seja bloqueado e aberto.