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 |
---|---|
|
The call succeeded. |
|
Object not found. |
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 |
Inquiry function |
Return |
---|---|---|
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 |