네이티브 응용 프로그램의 오류 처리

Microsoft Visual C++ for Devices로 개발하는 응용 프로그램의 경우 런타임 응용 프로그램 또는 데이터 공급자로부터 오류 정보를 얻거나 Microsoft SQL Server Compact 3.5(SQL Server Compact 3.5) ActiveX 오류 제어 개체 또는 컬렉션을 사용하여 오류 정보를 얻을 수 있습니다. SQL Server Compact 3.5 오류 제어 개체 및 컬렉션을 사용하는 것은 Replication, RemoteDataAccess 및 Engine 개체 오류를 처리하는 방법입니다.

오류 정보 검색

Microsoft Visual C++ for Devices로 작성된 응용 프로그램은 HRESULT보다 SQL Server Compact 3.5에서 자세한 정보를 검색할 수 있습니다. 확장 오류 정보를 검색하는 방법은 응용 프로그램이 SQL Server Compact 3.5과 상호 작용하기 위해 다음 중 어떤 방법을 사용하는가에 따라 달라집니다.

  • OLE DB 오류 개체
    SQL Server Compact 3.5용 OLE DB 공급자는 OLE DB 오류 개체를 사용하여 액세스할 수 있는 다양한 오류 개체를 반환합니다. OLE DB 오류 개체는 여러 계층의 오류를 저장하여 일반 오류 이상의 추가 정보를 제공합니다. 자세한 내용은 OLE DB 오류 개체 사용(SQL Server Compact)을 참조하십시오.
  • SQL Server Compact 3.5 오류 제어 개체 및 컬렉션
    Replication, RemoteDataAccess 및 Engine 개체는 Visual C++를 통해 액세스할 수 있는 오류 컬렉션 및 매개 변수를 표시합니다. 이 네이티브 프로그램은 sqlce_sync.hto를 프로젝트 참조에 추가하고 include 지시문을 사용하여 이 파일을 참조하는 방식으로 SQL Server의 오류 개체 및 컬렉션을 참조합니다. 자세한 내용은 원시 오류 개체 프로그래밍(SQL Server Compact)을 참조하십시오.

네이티브 오류 제어 개체 및 컬렉션 사용

SSCEErrors 컬렉션에는 생성된 각각의 오류에 대한 SSCEError 개체가 포함되어 있습니다. 각 SSCEError 개체에는 SSCEParams 컬렉션이 포함되어 있습니다. 오류에 대한 설명은 SSCEParams 컬렉션의 SSCEParam 개체에서 검색할 수 있습니다. SQL Server와 달리 SQL Server Compact 3.5에서는 6개의 매개 변수 컬렉션으로 오류에 대한 자세한 정보를 반환합니다. 오류 메시지를 작성할 때는 SSCEError 개체 각각에 대한 SSCEParams 컬렉션에서 각 SSCEParam 개체를 검색할 수 있도록 일련의 중첩된 FOR 루프를 사용하십시오.

예

다음 예에서는 Visual C++ for Devices를 사용하여 Replication, RemoteDataAccess 및 Engine 개체 오류를 표시하는 방법을 보여 줍니다.

// Error handling example
#include     "sqlce_sync.h"

void    ShowErrors(ISSCEErrors* pISSCEErrors)
{
HRESULT       hr;
LONG          cbBuf;
LONG          i;
LONG          lErrorCount;
LONG          lErrorIndex;
LONG          lParamCount;
LONG          lParamIndex;
VARIANT       var;
VARIANT       varParam;
WCHAR         wszBuff[4096];
WCHAR*        pwszBuffPos   = &wszBuff[0];
BSTR          bstr;
ISSCEError*   pISSCEError   = NULL;
ISSCEParams*  pISSCEParams  = NULL;
ISSCEParam*   pISSCEParam   = NULL;
BOOL          fSuccess      = FALSE;

// Initialize the variants.
VariantInit(&var);
VariantInit(&varParam);

// Get the count of errors.
if(FAILED(hr = pISSCEErrors->get_Count(&lErrorCount))) goto Exit;
if (lErrorCount <= 0)
    {
    MessageBox(NULL, L"No extended error information.",L"ShowErrors", MB_OK);
    fSuccess = TRUE;
    goto Exit;
    }

// Display errors, one at a time, in a single message box.
// If there are too many errors, they might not all display correctly.
// If so, we recommend that you perform logic based on the number of errors.
for (lErrorIndex = 0; lErrorIndex < lErrorCount; lErrorIndex++)
    {
    cbBuf = swprintf(pwszBuffPos, L"E R R O R  %d of %d\r\n",
        lErrorIndex+1, lErrorCount);
    pwszBuffPos += cbBuf;

    // Get the next error record.
    var.vt = VT_I4;
    var.lVal = lErrorIndex;
    if(FAILED(hr = pISSCEErrors->get_Item(var, &pISSCEError))) goto Exit;

    // Error description
    if (FAILED(hr = pISSCEError->get_Description(&bstr))) goto Exit;
    cbBuf = swprintf(pwszBuffPos, L"DESCRIPTION: '%s'\r\n", bstr);
    pwszBuffPos += cbBuf;
    SysFreeString(bstr);

    // Error number
    if (FAILED(hr = pISSCEError->get_Number(&i))) goto Exit;
    cbBuf = swprintf(pwszBuffPos, L"NUMBER: %8.8X\r\n", i);
    pwszBuffPos += cbBuf;

    // Native error
    if (FAILED(hr = pISSCEError->get_NativeError(&i))) goto Exit;
    cbBuf = swprintf(pwszBuffPos, L"NATIVE_ERROR: %d\r\n", i);
    pwszBuffPos += cbBuf;

    // Error source
    if (FAILED(hr = pISSCEError->get_Source(&bstr))) goto Exit;
    cbBuf = swprintf(pwszBuffPos, L"SOURCE: '%s'\r\n", bstr);
    pwszBuffPos += cbBuf;
    SysFreeString(bstr);

    // Retrieve the error parameters.
    if (FAILED(hr = pISSCEError->get_Params(&pISSCEParams))) goto Exit;

    // Get the number of error parameters.
    if (FAILED(hr = pISSCEParams->get_Count(&lParamCount))) goto Exit;

    // Display the value of each parameter.
    for (lParamIndex = 0; lParamIndex < lParamCount; lParamIndex++)
        {

        // Get the parameter object.
        var.vt = VT_I4;
        var.lVal = lParamIndex;
        if (FAILED(hr = pISSCEParams->get_Item(var, &pISSCEParam))) goto Exit;

        // Get and display the parameter value.
        if (FAILED(hr = pISSCEParam->get_Param(&varParam))) goto Exit;
        if (VT_I4 == varParam.vt || VT_UI4 == varParam.vt)
            {
            cbBuf = swprintf(pwszBuffPos, L"P%d: %d\r\n", lParamIndex,
                (LONG) varParam.lVal);
            }
        else if (VT_I2 == varParam.vt || VT_UI2 == varParam.vt)
            {
            cbBuf = swprintf(pwszBuffPos, L"P%d: %d\r\n", lParamIndex,
                (LONG) varParam.iVal);
            }
        else if (VT_BSTR == varParam.vt)
            {
            cbBuf = swprintf(pwszBuffPos, L"P%d: '%s'\r\n", lParamIndex, 
                varParam.bstrVal);
            }
        pwszBuffPos += cbBuf;

        // Clear the variant.
        VariantClear(&varParam);

        // Release the parameter object.
        pISSCEParam->Release();
        pISSCEParam = NULL;
        }
    cbBuf = swprintf(pwszBuffPos, L"\r\n");
    pwszBuffPos += cbBuf;

    }

// Display the error information.

MessageBox(NULL, wszBuff,L"Error", MB_OK);
fSuccess = TRUE;

Exit:
// Release the parameter object.
if (pISSCEParam)
    {
    pISSCEParam->Release();
    pISSCEParam = NULL;
    }

// Release the parameters object.
if (pISSCEParams)
    {
    pISSCEParams->Release();
    pISSCEParams = NULL;
    }

// Release the error object.
if (pISSCEError)
    {
    pISSCEError->Release();
    pISSCEError = NULL;
    }

// The Errors object is released in calling routine.
if (!fSuccess)
    {
    MessageBox(NULL, L"Error while processing errors!",L"ShowErrors", MB_OK);
    }
return;
}

참고 항목

관련 자료

원시 오류 개체 프로그래밍(SQL Server Compact)

도움말 및 정보

지원 받기(SQL Server Compact 3.5 서비스 팩 1)