Share via


ISQLServerErrorInfo::GetErrorInfo (ole db)

Returns a pointer to a SQL Serveryerel istemci ole db sağlayıcısı SSERRORINFO yapısı içeren SQL Serverhata ayrıntıları.

Sözdizimi

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

Bağımsız değişkenler

  • PpSSErrorInfo[out]
    SSERRORINFO yapısı için işaretçi. Yöntem başarısız olur veya varsa hiç SQL Serverhata ile ilgili bilgileri, sağlayıcı herhangi bir bellek ayırmaz ve değiştirilememesini sağlar ppSSErrorInfoDeğiştirgenin bir null işaretçi çıktı.

  • ppErrorStrings[out]
    Unicode karakter işaretçi için işaretçi. Yöntem başarısız olur veya varsa hiç SQL Serverbir hata ile ilgili bilgileri, sağlayıcı herhangi bir bellek ayırmaz ve değiştirilememesini sağlar ppErrorStringsDeğiştirgenin bir null işaretçi çıktı. Azat ppErrorStringsdeğişkeniyle IMalloc::Free yöntemi boşaltır dönen SSERRORINFO yapısı, üç ayrı dize üyeleri olarak bellek bloğunda tahsis edilir.

Dönüş Kodu Değerleri

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

  • E_INVALIDARG
    Ya ppSSErrorInfoya da ppErrorStringsbağımsız değişkeni null oldu.

  • E_OUTOFMEMORY
    SQL ServerYerel istemci ole db sağlayıcısı değil tahsis isteği tamamlamak için yeterli bellek yok.

Açıklamalar

SQL ServerYerel istemci ole db sağlayıcısı tüketici tarafından geçirilen işaretçiler ile döndürülen SSERRORINFO ve olechar dizeleri için bellek ayırır. Tüketici bu bellek kullanarak ayırması gerekir IMalloc::Free artık hata veri erişimi gerektiriyorsa yöntemi.

SSERRORINFO yapısı 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;

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. İleti aracılığıyla verilir IErrorInfo::GetDescription yöntemi.

pwszServer

Örnek adı SQL Serverhata oluştuğu tarih.

pwszProcedure

Bir saklı yordam hata oluştuysa hata üretme saklı yordam adı; Aksi halde, boş bir dize.

lNative

SQL ServerHata numarası. Bu döndürülen hata numarası aynıdır plNativeErrorparametresi ISQLErrorInfo::GetSQLInfo yöntemi.

bState

Devlet SQL Serverhata.

bSınıf

Şiddeti SQL Serverhata.

wLineNumber

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

İşaretçiler yapısındaki başvuru adresleri döndürülen dize ppErrorStringsdeğişkeni.

Ayrıca bkz.

Başvuru

RAISERROR (Transact-SQL)

Diğer Kaynaklar

ISQLServerErrorInfo (ole db)