Expand Minimize

RpcObjectInqType function

The RpcObjectInqType function returns the type of an object.

Syntax


RPC_STATUS RPC_ENTRY 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

ValueMeaning
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 registeredInquiry function registeredReturn value
Yes ( RpcObjectSetType)IgnoredThe object's registered type UUID.
NoYes ( RpcObjectSetInqFn)The type UUID returned from the inquiry function.
NoNoThe nil UUID.

 

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Rpcdce.h (include Rpc.h)

Library

Rpcrt4.lib

DLL

Rpcrt4.dll

See also

RpcObjectSetInqFn
RpcObjectSetType

 

 

Community Additions

ADD
Show:
© 2014 Microsoft