Função RpcObjectSetInqFn (rpcdce.h)

A função RpcObjectSetInqFn registra uma função de investigação de objeto. Um valor nulo desativa uma função de investigação de objeto registrada anteriormente.

Sintaxe

RPC_STATUS RpcObjectSetInqFn(
  RPC_OBJECT_INQ_FN *InquiryFn
);

Parâmetros

InquiryFn

Função de consulta de tipo de objeto. Consulte RPC_OBJECT_INQ_FN. Quando um aplicativo chama RpcObjectInqType e a biblioteca de tempo de execução RPC descobre que o objeto especificado não está registrado, a biblioteca em tempo de execução chama automaticamente RpcObjectSetInqFn para determinar o tipo do objeto.

Retornar valor

Essa função retorna o valor a seguir.

Valor Significado
RPC_S_OK
A chamada foi bem-sucedida.
 
Nota Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.
 

Comentários

Um aplicativo de servidor chama RpcObjectSetInqFn para substituir a função de mapeamento padrão que mapeia UUIDs de objeto para digitar UUIDs, que determinam o tipo de um objeto. Se um aplicativo mantiver privadamente um registro de objeto/tipo, a função de consulta especificada retornará o tipo UUID de um objeto.

A biblioteca de tempo de execução RPC chama automaticamente a função de consulta quando o aplicativo chama RpcObjectInqType e o objeto de interesse não foi registrado anteriormente com RpcObjectSetType. Os valores TypeUuid e Status da função RPC_OBJECT_INQ_FN são retornados como a saída de RpcObjectInqType.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho rpcdce.h (inclua Rpc.h)
Biblioteca Rpcrt4.lib
DLL Rpcrt4.dll

Confira também

RpcObjectInqType

RpcObjectSetType