Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
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. |
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 |
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 |