RpcObjectInqType function (rpcdce.h)

The RpcObjectInqType function returns the type of an object.

Syntax

RPC_STATUS RpcObjectInqType(
  UUID *ObjUuid,
  UUID *TypeUuid
);

Parameters

ObjUuid

Pointer to the object UUID whose associated type UUID is returned.

TypeUuid

Returns a pointer to the type UUID of the ObjUuid parameter.

Specify a parameter 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.

Return value

Value Meaning
RPC_S_OK
The call succeeded.
RPC_S_OBJECT_NOT_FOUND
Object not found.
 
Note  For a list of valid error codes, see RPC Return Values.
 

Remarks

A server application calls RpcObjectInqType to obtain the type UUID of an object. If the object was registered with the RPC run-time library using the RpcObjectSetType function, 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 under RpcObjectSetInqFn). The RPC run-time library uses that function to determine an object's type.

The RpcObjectInqType function obtains the 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.
 
 

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header rpcdce.h (include Rpc.h)
Library Rpcrt4.lib
DLL Rpcrt4.dll

See also

RpcObjectSetInqFn

RpcObjectSetType