RpcObjectInqType
The RpcObjectInqType
function returns the type of an object.
This function
is supported by both 32-bit platforms Windows NT and Windows 95.
#include <rpc.h>
RPC_STATUS RPC_ENTRY RpcObjectInqType(
|
UUID *
ObjUuid, |
|
|
UUID *
TypeUuid |
|
|
); |
|
Parameters
ObjUuid
Points to the
object UUID whose associated type UUID is returned.
TypeUuid
Returns a
pointer to the type UUID of the ObjUuid argument.
Specify an
argument value of NULL to prevent the return of a type UUID. In this way, an
application can determine (from the returned status) whether ObjUuid is
registered without specifying an output type UUID variable.
Remarks
A server
application calls the RpcObjectInqType routine to obtain the type UUID
of an object.
If the object
was registered with the RPC run-time library using the RpcObjectSetType
routine, the registered type is returned.
Optionally,
an application can privately maintain an object/type registration. In this
case, if the application has provided an object inquiry function (see RpcObjectSetInqFn), the RPC run-time library
uses that function to determine an object s type.
The RpcObjectInqType
routine obtains the returned type UUID as described in the following table:
|
Object
UUID |
Inquiry
function |
Return |
|
Yes (RpcObjectSetType) |
Ignored |
The
object s registered type UUID |
|
No |
Yes (RpcObjectSetInqFn) |
The type
UUID returned from the inquiry function |
|
No |
No |
The nil
UUID |
Return Values
|
Value |
Meaning |
|
RPC_S_OK |
Success |
|
RPC_S_OBJECT_NOT_FOUND |
Object not
found |
See Also