Aracılığıyla paylaş


ISQLServerErrorInfo::GetErrorInfo (OLE DB)

Bir işaretçi döndürür bir SQL Server Yerel istemci OLE DB sağlayıcı SSERRORINFO yapısı içeren SQL Server Hata ayrıntıları.

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

Bağımsız değişkenler

  • ppSSErrorInfo[Çıkış]
    Bir SSERRORINFO yapısı BIR imleç.Yöntem başarısız olur veya varsa yok SQL Server hata ile ilgili bilgi için sağlayıcı bir bellek ayırma ve, sağlar ppSSErrorInfo bağımsız değişken bir null işaretçi çıktıyı.

  • ppErrorStrings[Çıkış]
    Bir Unicode karakter dizesi işaretçisi BIR işaretçi.Yöntem başarısız olur veya varsa yok SQL Server bir hata ile ilgili bilgi için sağlayıcı bir bellek ayırma ve, sağlar ppErrorStrings bağımsız değişken, çıktı üzerinde null bir işaretçidir. Boşaltma ppErrorStrings bağımsız değişkenle IMalloc::Free yöntem, bir bloğunda ayrılan bellek gibi döndürülen SSERRORINFO yapısı, üç tek tek bir dize üyeleri serbest bırakır.

Dönüş Kodu Değerleri

  • s_ok
    Yöntem başarılı oldu.

  • e_invalidarg
    Her iki ppSSErrorInfo veya ppErrorStrings bağımsız değişken NULL idi.

  • e_outofmemory
    The SQL Server Native istemci OLE DB sağlayıcı could not allocate sufficient memory to complete the request.

Remarks

The SQL Server Native istemci OLE DB sağlayıcı allocates memory for the SSERRORINFO and OLECHAR strings returned through the pointers passed by the consumer. Tüketici kullanarak bu bellek ayırması gereken IMalloc::Free yöntem artık hata verilere erişim istediğinde.

SSERRORINFO yapısını aşağıdaki gibi tanımlanır:

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

Üye

Açıklama

pwszMessage

Hata iletisinden SQL Server. Ileti ile döndürülen IErrorInfo::GetDescription yöntem.

pwszServer

örnek adı SQL Server hangi hata oluştu.

pwszProcedure

saklı yordam içinde saklı bir yordam hata oluştu, hata oluşturma; yoksa, boş bir dize.

lNative

The SQL Server error number.Hata numarasını, döndürülen aynıdır plNativeError parametre ISQLErrorInfo::GetSQLInfo yöntem.

bState

Durumunu SQL Server Hata.

bSınıf

Önem derecesi SQL Server Hata.

wLineNumber

Uygun olduğunda, satır bir SQL Server hata iletisini oluşturan saklı yordam. Hiçbir yordam, söz konusu ise, varsayılan değer 1'dir.

Döndürülen dizgiyi adresleri işaretçileri yapısında başvuru ppErrorStrings bağımsız değişken.