RpcObjectSetInqFn function (rpcdce.h)

Article
02/22/2024

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
RPC_S_OK	The call succeeded.

Note For a list of valid error codes, see RPC Return Values.

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