문서를 영문으로 보려면 영문 확인란을 선택하세요. 마우스 포인터를 텍스트 위로 이동시켜 팝업 창에서 영문 텍스트를 표시할 수도 있습니다.
번역
영문

ISQLServerErrorInfo::GetErrorInfo(OLE DB)

SQL Server 오류 정보가 포함된 SQL Server Native Client OLE DB 공급자 SSERRORINFO 구조에 대한 포인터를 반환합니다.

HRESULT GetErrorInfo(
   SSERRORINFO**ppSSErrorInfo,
   OLECHAR**ppErrorStrings);

ppSSErrorInfo[out]

SSERRORINFO 구조에 대한 포인터입니다. 메서드가 실패하거나 오류와 연관된 SQL Server 정보가 없는 경우 공급자는 메모리를 할당하지 않고 출력에서 ppSSErrorInfo 인수가 Null 포인터인지 확인합니다.

ppErrorStrings[out]

유니코드 문자열 포인터에 대한 포인터입니다. 메서드가 실패하거나 오류와 연결된 SQL Server 정보가 없는 경우 공급자는 메모리를 할당하지 않고 출력에서 ppErrorStrings 인수가 Null 포인터인지 확인합니다. IMalloc::Free 메서드를 사용하여 ppErrorStrings 인수를 해제하면 메모리가 블록에 할당될 때 반환된 SSERRORINFO 구조에 있는 세 개의 각 문자열 멤버가 해제됩니다.

S_OK

메서드가 성공했습니다.

E_INVALIDARG

ppSSErrorInfo 또는 ppErrorStrings 인수가 NULL입니다.

E_OUTOFMEMORY

SQL Server Native Client OLE DB 공급자가 요청을 완료할 수 있을 만큼 충분한 메모리를 할당할 수 없습니다.

SQL Server Native Client OLE DB 공급자가 소비자에 의해 전달된 포인터를 통해 반환된 SSERRORINFO 및 OLECHAR 문자열을 위한 메모리를 할당했습니다. 소비자는 오류 데이터에 액세스할 필요가 없게 되면 IMalloc::Free 메서드를 사용하여 이 메모리의 할당을 취소해야 합니다.

SSERRORINFO 구조는 다음과 같이 정의됩니다.

typedef struct tagSSErrorInfo
   {
   LPOLESTR pwszMessage;
   LPOLESTR pwszServer;
   LPOLESTR pwszProcedure;
   LONG lNative;
   BYTE bState;
   BYTE bClass;
   WORD wLineNumber;
   }
SSERRORINFO;

멤버

설명

pwszMessage

SQL Server에서 전달하는 오류 메시지입니다. 이 메시지는 IErrorInfo::GetDescription 메서드를 통해 반환됩니다.

pwszServer

오류가 발생한 SQL Server 인스턴스의 이름입니다.

pwszProcedure

오류가 저장 프로시저에서 발생한 경우에는 오류를 생성한 저장 프로시저의 이름이고, 그렇지 않으면 빈 문자열입니다.

lNative

SQL Server 오류 번호입니다. 오류 번호는 ISQLErrorInfo::GetSQLInfo 메서드의 plNativeError 매개 변수에 반환되는 번호와 동일합니다.

bState

SQL Server 오류의 상태입니다.

bClass

SQL Server 오류의 심각도입니다.

wLineNumber

해당되는 경우 오류 메시지가 발생한 SQL Server 저장 프로시저의 줄입니다. 저장 프로시저가 연관되지 않은 경우 기본값은 1입니다.

ppErrorStrings 인수에 반환된 문자열의 구조 참조 주소에 있는 포인터입니다.

커뮤니티 추가 항목

추가
표시: