LookupIDByType(D3nfb)

LookupIDByType -- find object with specified identifier and type

Synopsis

pointer
LookupIDByType(id, rtype)
    XID id;
    RESTYPE rtype;

Description

LookupIDByType( ) returns the object with the given id and type, or NULL.

Arguments

id
rtype

Exit codes

Usage notes

A resource ID is a 32 bit quantity, the upper 3 bits of which are limits for client-visible resources. The next 7 bits are used as client ID, and the low 22 bits come from the client. A resource ID is ``hashed'' by extracting and x'oring subfields (varying with the size of the hash table).

It is sometimes necessary for the server to create an ID that looks like it belongs to a client. This ID, however, must not be one the client actually can create, or we have the potential for conflict. The 30th bit of the ID is reserved for the server's use for this purpose. By setting CLIENT_ID(id) to the client, the SERVER_BIT to 1, and an otherwise arbitrary ID in the low 22 bits, a resource is created that is "owned" by the client.

Version applicability

This function is supported for NFB drivers on all releases of SCO OpenServer 5, SVR5, and AIX 5L.