Udostępnij przez

Uzyskaj port

Port reprezentuje połączenie z maszyną, na której są uruchomione procesy. Ta maszyna może być maszyną lokalną lub maszyną zdalną (która może być uruchomiona w systemie operacyjnym innym niż Windows; zobacz Porty , aby uzyskać więcej informacji).

Port jest reprezentowany przez interfejs IDebugPort2 . Służy do uzyskiwania informacji o procesach uruchomionych na maszynie, z którym jest połączony port.

Aparat debugowania potrzebuje dostępu do portu w celu zarejestrowania węzłów programu przy użyciu portu i spełnienia żądań dotyczących informacji o procesie. Jeśli na przykład aparat debugowania implementuje interfejs IDebugProgramProvider2 , implementacja metody GetProviderProcessData może poprosić port o zwrócenie niezbędnych informacji o procesie.

Program Visual Studio dostarcza aparatowi debugowania niezbędny port, który uzyskuje od dostawcy portów. Jeśli program jest dołączony do (z poziomu debugera lub z powodu wyjątku, który wyzwala okno dialogowe Just-in-Time [JIT], użytkownik otrzymuje wybór transportu (inną nazwę dostawcy portów) do użycia. W przeciwnym razie, jeśli użytkownik uruchamia program z poziomu debugera, system projektu określa dostawcę portu do użycia. W obu przypadkach program Visual Studio instancjonuje dostawcę portów reprezentowanego przez interfejs IDebugPortSupplier2 i żąda nowego portu, wywołując AddPort z interfejsem IDebugPortRequest2. Ten port jest następnie przekazywany do silnika debugowania w takiej czy innej formie.

Example

W tym fragmencie kodu pokazano, jak używać portu dostarczonego do LaunchSuspended w celu zarejestrowania węzła programu w ResumeProcess. Parametry niezwiązane bezpośrednio z tą koncepcją zostały pominięte w celu zapewnienia przejrzystości.

Uwaga / Notatka

W tym przykładzie użyto portu do uruchomienia i wznowienia procesu i przyjęto założenie, że interfejs IDebugPortEx2 jest implementowany na porcie. Nie jest to w żadnym razie jedyny sposób wykonywania tych zadań, i istnieje możliwość, że port może nawet nie być zaangażowany inaczej niż poprzez przekazanie mu IDebugProgramNode2 programu.

// This is an IDebugEngineLaunch2 method.
HRESULT CDebugEngine::LaunchSuspended(/* omitted parameters */,
                                      IDebugPort2 *pPort,
                                      /* omitted parameters */,
                                      IDebugProcess2**ppDebugProcess)
{
    // do stuff here to set up for a launch (such as handling the other parameters)
    ...

    // Now get the IPortNotify2 interface so we can register a program node
    // in CDebugEngine::ResumeProcess.
    CComPtr<IDebugDefaultPort2> spDefaultPort;
    HRESULT hr = pPort->QueryInterface(&spDefaultPort);
    if (SUCCEEDED(hr))
    {
        CComPtr<IDebugPortNotify2> spPortNotify;
        hr = spDefaultPort->GetPortNotify(&spPortNotify);
        if (SUCCEEDED(hr))
        {
            // Remember the port notify so we can use it in ResumeProcess.
            m_spPortNotify = spPortNotify;

            // Now launch the process in a suspended state and return the
            // IDebugProcess2 interface
            CComPtr<IDebugPortEx2> spPortEx;
            hr = pPort->QueryInterface(&spPortEx);
            if (SUCCEEDED(hr))
            {
                // pass on the parameters we were given (omitted here)
                hr = spPortEx->LaunchSuspended(/* omitted parameters */,ppDebugProcess)
            }
        }
    }
    return(hr);
}

HRESULT CDebugEngine::ResumeProcess(IDebugProcess2 *pDebugProcess)
{
    // Make a program node for this process
    HRESULT hr;
    CComPtr<IDebugProgramNode2> spProgramNode;
    hr = this->GetProgramNodeForProcess(pProcess, &spProgramNode);
    if (SUCCEEDED(hr))
    {
        hr = m_spPortNotify->AddProgramNode(spProgramNode);
        if (SUCCEEDED(hr))
        {
            // resume execution of the process using the port given to us earlier.
            // (Querying for the IDebugPortEx2 interface is valid here since
            // that's how we got the IDebugPortNotify2 interface in the first place.)
            CComPtr<IDebugPortEx2> spPortEx;
            hr = m_spPortNotify->QueryInterface(&spPortEx);
            if (SUCCEEDED(hr))
            {
                hr = spPortEx->ResumeProcess(pDebugProcess);
            }
        }
    }
    return(hr);
}

Treści powiązane

  • Last updated on