IErrorInfo::GetSource

Returns the name of the component that generated the error, such as "ODBC driver-name."

HRESULT GetSource (
   BSTR *   pbstrSource);

Parameters

pbstrSource

[out]
A pointer to memory in which to return a pointer to the name of the component that generated the error. If an error occurs, *pbstrSource is set to a null pointer. The memory for this string is allocated by the provider and must be freed by the consumer with a call to SysFreeString.

Return Code

S_OK
The method succeeded.

E_INVALIDARG
pbstrSource was a null pointer.

E_OUTOFMEMORY
The provider was unable to allocate sufficient memory in which to return the component name.

DB_E_NOLOCALE
The locale ID specified by the lcid parameter in IErrorRecords::GetErrorInfo was not supported by the provider.

Comments

The implementation of this method shipped with the OLE DB SDK calls IErrorLookup::GetErrorDescription to retrieve the error source.

See Also

IErrorLookup::GetErrorDescription