Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All
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:
© 2015 Microsoft