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
| 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
|
Minimum supported client |
Windows 2000 Professional [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows 2000 Server [desktop apps only] |
|
Header |
|
|
Library |
|
|
DLL |
|
See also