RpcObjectSetInqFn function (rpcdce.h)
The RpcObjectSetInqFn function registers an object-inquiry function. A null value turns off a previously registered object-inquiry function.
Syntax
RPC_STATUS RpcObjectSetInqFn(
RPC_OBJECT_INQ_FN *InquiryFn
);
Parameters
InquiryFn
Object-type inquiry function. See RPC_OBJECT_INQ_FN. When an application calls RpcObjectInqType and the RPC run-time library finds that the specified object is not registered, the run-time library automatically calls RpcObjectSetInqFn to determine the object's type.
Return value
This function returns the following value.
| Value | Meaning |
|---|---|
|
The call succeeded. |
Remarks
A server application calls RpcObjectSetInqFn to override the default mapping function that maps object UUIDs to type UUIDs, which determine an object's type. If an application privately maintains an object/type registration, the specified inquiry function returns the type UUID of an object.
The RPC run-time library automatically calls the inquiry function when the application calls RpcObjectInqType and the object of interest was not previously registered with RpcObjectSetType. The TypeUuid and Status values of the RPC_OBJECT_INQ_FN function are returned as the output from RpcObjectInqType.
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 |