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
registered		 Inquiry function
registered		 Return
value
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

QuickInfo

  Windows NT: Yes
  Windows CE: Unsupported.
  Header: Declared in rpcdce.h.
  Import Library: Link with rpcrt4.lib.

See Also

RpcObjectSetInqFn, RpcObjectSetType