IDebugPendingBreakpoint2::CanBind

Artículo
01/12/2024

Determina si este punto de interrupción pendiente puede enlazarse a una ubicación de código.

Sintaxis

int CanBind ( 
   out IEnumDebugErrorBreakpoints2 ppErrorEnum
);

HRESULT CanBind ( 
   IEnumDebugErrorBreakpoints2** ppErrorEnum
);

Parámetros

ppErrorEnum
[out] Devuelve un objeto IEnumDebugErrorBreakpoints2 que contiene una lista de objetos IDebugErrorBreakpoint2 si se pueden producir errores.

Valor devuelto

Si se ejecuta correctamente, devuelve S_OK. Devuelve S_FALSE si el punto de interrupción no se puede enlazar, en cuyo caso el ppErrorEnum parámetro devuelve los errores. De lo contrario, devuelve un código de error. Devuelve E_BP_DELETED si se ha eliminado el punto de interrupción.

Comentarios

Se llama a este método para determinar qué ocurriría si se enlazase este punto de interrupción pendiente. Llame al método Bind para enlazar realmente el punto de interrupción pendiente.

Ejemplo

En el ejemplo siguiente se muestra cómo implementar este método para un objeto simple CPendingBreakpoint que expone la interfaz IDebugPendingBreakpoint2 .

HRESULT CPendingBreakpoint::CanBind(IEnumDebugErrorBreakpoints2** ppErrorEnum)
{
   HRESULT hr;
   HRESULT hrT;

   // Check for a valid pointer to an error breakpoint enumerator
   // interface; otherwise, return hr = E_INVALIDARG.
   if (ppErrorEnum)
   {
      // Verify that the pending breakpoint has not been deleted. If
      // deleted, then return hr = E_BP_DELETED.
      if (m_state.state != PBPS_DELETED)
      {
         // Verify that the breakpoint is a file/line breakpoint.
         if (IsFlagSet(m_pBPRequest->m_bpRequestInfo.dwFields, BPREQI_BPLOCATION) &&
             m_pBPRequest->m_bpRequestInfo.bpLocation.bpLocationType == BPLT_CODE_FILE_LINE)
         {
            hr = S_OK;
         }
         // If the breakpoint type is not a file/line breakpoint, then the
         // result should be an error breakpoint.
         else
         {
            // If the error breakpoint member variable does not have
            // allocated memory.
            if (!m_pErrorBP)
            {
               // Create, AddRef, and initialize a CErrorBreakpoint object.
               if (CComObject<CErrorBreakpoint>::CreateInstance(&m_pErrorBP) == S_OK)
               {
                  m_pErrorBP->AddRef();
                  m_pErrorBP->Initialize(this);
               }
            }

            // Create a new enumerator of error breakpoints.
             CComObject<CEnumDebugErrorBreakpoints>* pErrorEnum;
            if (CComObject<CEnumDebugErrorBreakpoints>::CreateInstance(&pErrorEnum) == S_OK)
            {
               // Get the IDebugErrorBreakpoint2 information for the
               // CErrorBreakpoint object.
               CComPtr<IDebugErrorBreakpoint2> spErrorBP;
               hrT = m_pErrorBP->QueryInterface(&spErrorBP);
               assert(hrT == S_OK);
               if (hrT == S_OK)
               {
                  // Initialize the new enumerator of error breakpoints
                  // with the IDebugErrorBreakpoint2 information.
                  IDebugErrorBreakpoint2* rgpErrorBP[] = { spErrorBP.p };
                  hrT = pErrorEnum->Init(rgpErrorBP, &(rgpErrorBP[1]), NULL, AtlFlagCopy);
                  if (hrT == S_OK)
                  {
                     // Verify that the passed IEnumDebugErrorBreakpoints2
                     // interface can be successful queried by the
                     // created CEnumDebugErrorBreakpoints object.
                     hrT = pErrorEnum->QueryInterface(ppErrorEnum);
                     assert(hrT == S_OK);
                  }
               }

               // Otherwise, delete the CEnumDebugErrorBreakpoints object.
               if (FAILED(hrT))
               {
                  delete pErrorEnum;
               }
            }

            hr = S_FALSE;
         }
      }
      else
      {
         hr = E_BP_DELETED;
      }
   }
   else
   {
      hr = E_INVALIDARG;
   }

   return hr;
}

Compartir vía