IAccessor::AddRefAccessor

OLE DB Programmer's Reference

Adds a reference count to an existing accessor.

HRESULT AddRefAccessor (    HACCESSOR   hAccessor,    DBREFCOUNT *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 IAccessor::AddRefAccessor before passing it to another thread.

See Also

IAccessor::CreateAccessor | IAccessor::ReleaseAccessor

1998-2001 Microsoft Corporation. All rights reserved.



Microsoft Ole Db 2.0 Programmer's Reference and Data Access SDK
Microsoft OLE DB 2.0 Programmers Reference and Data Access SDK (Microsoft Professional Editions)
ISBN: 0735605904
EAN: 2147483647
Year: 1998
Pages: 1083

flylib.com © 2008-2017.
If you may any questions please contact us: flylib@qtcs.net