Classe CDBErrorInfo

Fornisce supporto per l'elaborazione degli errori OLE DB tramite l'interfaccia OLE DB IErrorRecords .

Sintassi

class CDBErrorInfo

Requisiti

Intestazione: atldbcli.h

Membri

Metodi

Osservazioni:

Questa interfaccia restituisce uno o più record di errore all'utente. Chiamare prima CDBErrorInfo::GetErrorRecords per ottenere un conteggio dei record di errore. Chiamare quindi una delle funzioni di accesso, ad esempio CDBErrorInfo::GetAllErrorInfo, per recuperare le informazioni sugli errori per ogni record.

CDBErrorInfo::GetAllErrorInfo

Restituisce tutti i tipi di informazioni sugli errori contenute in un record di errore.

Sintassi

HRESULT GetAllErrorInfo(ULONG ulRecordNum,
   LCID lcid,  BSTR* pbstrDescription,
   BSTR* pbstrSource = NULL,
   GUID* pguid = NULL,
   DWORD* pdwHelpContext = NULL,
   BSTR* pbstrHelpFile = NULL) const throw();

Parametri

ulRecordNum
[in] Numero in base zero del record per il quale restituire informazioni sull'errore.

lcid
[in] ID delle impostazioni locali per le informazioni sull'errore da restituire.

pbstrDescription
[out] Puntatore a una descrizione testuale dell'errore o NULL se le impostazioni locali non sono supportate. Vedere la sezione Osservazioni.

pbstrSource
[out] Puntatore a una stringa contenente il nome del componente che ha generato l'errore.

pguid
[out] Puntatore al GUID dell'interfaccia che ha definito l'errore.

pdwHelpContext
[out] Puntatore all'ID del contesto della Guida per l'errore.

pbstrHelpFile
[out] Puntatore a una stringa contenente il percorso del file della Guida che descrive l'errore.

Valore restituito

S_OK se ha esito positivo. Vedere IErrorRecords::GetErrorInfo nella guida di riferimento per programmatori OLE DB per altri valori restituiti.

Osservazioni:

Il valore di output di pbstrDescription viene ottenuto internamente chiamando IErrorInfo::GetDescription, che imposta il valore su NULL se le impostazioni locali non sono supportate o se entrambe le condizioni seguenti sono vere:

1. il valore di lcid è NOT U.S. English e

2. il valore di lcid non è uguale al valore restituito da GetUserDefaultLCID.

CDBErrorInfo::GetBasicErrorInfo

Chiama IErrorRecords::GetBasicErrorInfo per restituire informazioni di base sull'errore, ad esempio il codice restituito e il numero di errore specifico del provider.

Sintassi

HRESULT GetBasicErrorInfo(ULONG ulRecordNum,
   ERRORINFO* pErrorInfo) const throw();

Parametri

Vedere IErrorRecords::GetBasicErrorInfo nella guida di riferimento per programmatori OLE DB.

Valore restituito

HRESULT standard.

CDBErrorInfo::GetCustomErrorObject

Chiama IErrorRecords::GetCustomErrorObject per restituire un puntatore a un'interfaccia in un oggetto errore personalizzato.

Sintassi

HRESULT GetCustomErrorObject(ULONG ulRecordNum,
   REFIID riid,IUnknown** ppObject) const throw();

Parametri

Vedere IErrorRecords::GetCustomErrorObject nella guida di riferimento per programmatori OLE DB.

Valore restituito

HRESULT standard.

CDBErrorInfo::GetErrorInfo

Chiama IErrorRecords::GetErrorInfo per restituire un puntatore dell'interfaccia IErrorInfo al record specificato.

Sintassi

HRESULT GetErrorInfo(ULONG ulRecordNum,
   LCID lcid,IErrorInfo** ppErrorInfo) const throw();

Parametri

Vedere IErrorRecords::GetErrorInfo nella guida di riferimento per programmatori OLE DB.

Valore restituito

HRESULT standard.

CDBErrorInfo::GetErrorParameters

Chiama IErrorRecords::GetErrorParameters per restituire i parametri di errore.

Sintassi

HRESULT GetErrorParameters(ULONG ulRecordNum,
   DISPPARAMS* pdispparams) const throw();

Parametri

Vedere IErrorRecords::GetErrorParameters nella guida di riferimento per programmatori OLE DB.

Valore restituito

HRESULT standard.

CDBErrorInfo::GetErrorRecords

Ottiene i record di errore per l'oggetto specificato.

Sintassi

HRESULT GetErrorRecords(IUnknown* pUnk,
   const IID& iid,
   ULONG* pcRecords) throw();

HRESULT GetErrorRecords(ULONG* pcRecords) throw();

Parametri

Punk
[in] Interfaccia all'oggetto per il quale ottenere i record di errore.

iid
[in] IID dell'interfaccia associata all'errore.

pcRecords
[out] Puntatore al conteggio (in base uno) dei record di errore.

Valore restituito

HRESULT standard.

Osservazioni:

Usare la prima forma della funzione se si desidera verificare da quale interfaccia ottenere le informazioni sull'errore. In caso contrario, utilizzare il secondo modulo.

Vedi anche

DBViewer
Modelli di consumer OLE DB
Riferimenti ai modelli consumer OLE DB