IAccessor::AddRefAccessor

Adds a reference count to an existing accessor.

HRESULT AddRefAccessor (
   HACCESSOR   hAccessor,
   ULONG *         pcRefCount);

Parameters

hAccessor

[in]
The handle of the accessor for which to increment the reference count.

pcRefCount

[out]
A pointer to memory in which to return the reference count of the accessor handle. If pcRefCount is a null pointer, no reference count is returned.

Return Code

S_OK
The method succeeded.

E_FAIL
A provider-specific error occurred.

E_UNEXPECTED
ITransaction::Commit or ITransaction::Abort was called and the object is in a zombie state. This error can be returned only when the method is called on a rowset.

DB_E_BADACCESSORHANDLE
hAccessor was invalid.

Comments

The consumer must increment the reference count on an accessor by calling AddRefAccessor before passing it to another thread.

See Also

IAccessor::CreateAccessor, IAccessor::ReleaseAccessor