Export (0) Print
Expand All
Expand Minimize

RpcObjectSetInqFn function

The RpcObjectSetInqFn function registers an object-inquiry function. A null value turns off a previously registered object-inquiry function.

Syntax


RPC_STATUS RPC_ENTRY 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.

ValueMeaning
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

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Rpcdce.h (include Rpc.h)

Library

Rpcrt4.lib

DLL

Rpcrt4.dll

See also

RpcObjectInqType
RpcObjectSetType

 

 

Community Additions

ADD
Show:
© 2014 Microsoft