この保留中のブレークポイントをコードの場所にバインドできるかどうかを判断します。
構文
パラメーター
ppErrorEnum
[出力] エラーが発生した可能性がある場合は、IDebugErrorBreakpoint2 オブジェクトの一覧を含む IEnumDebugErrorBreakpoints2 オブジェクトを返します。
戻り値
正常に終了した場合は、S_OK. を返します。ブレークポイントがバインドできない場合は、S_FALSE を返します。この場合、ppErrorEnum パラメーターによってエラーが返されます。 それ以外の場合はエラー コードを返します。 ブレークポイントが削除されている場合は、E_BP_DELETED を返します。
解説
このメソッドは、この保留中のブレークポイントがバインドされた場合に何が起きるのかを判断するために呼び出されます。 保留中のブレークポイントを実際にバインドするには、Bind メソッドを呼び出します。
例
次の例は、IDebugPendingBreakpoint2 インターフェイスを公開するシンプルな CPendingBreakpoint オブジェクトに対してこのメソッドを実装する方法を示しています。
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;
}