nf-rpcdce-rpcobjectinqtype.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NF:rpcdce.RpcObjectInqType	RpcObjectInqType function (rpcdce.h)	The RpcObjectInqType function returns the type of an object.	RpcObjectInqType RpcObjectInqType function [RPC] _rpc_rpcobjectinqtype rpc.rpcobjectinqtype rpcdce/RpcObjectInqType	rpc\rpcobjectinqtype.htm	Rpc	9146d4be-4a8a-4655-bd5b-e12f81fd4d23	12/05/2018	RpcObjectInqType, RpcObjectInqType function [RPC], _rpc_rpcobjectinqtype, rpc.rpcobjectinqtype, rpcdce/RpcObjectInqType	rpcdce.h	Rpc.h	Windows	Windows 2000 Professional [desktop apps only]	Windows 2000 Server [desktop apps only]										Rpcrt4.lib	Rpcrt4.dll		Windows			19H1	RpcObjectInqType rpcdce/RpcObjectInqType	c++	APIRef kbSyntax	DllExport	Rpcrt4.dll	RpcObjectInqType

RpcObjectInqType function

-description

The RpcObjectInqType function returns the type of an object.

-parameters

-param ObjUuid

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

-param 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.

-returns

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.

 

 

-see-also

RpcObjectSetInqFn

RpcObjectSetType