Função RpcObjectInqType (rpcdce.h)

  • Artigo

A função RpcObjectInqType retorna o tipo de um objeto .

Sintaxe

RPC_STATUS RpcObjectInqType(
  UUID *ObjUuid,
  UUID *TypeUuid
);

Parâmetros

ObjUuid

Ponteiro para o objeto UUID cujo tipo associado UUID é retornado.

TypeUuid

Retorna um ponteiro para o tipo UUID do parâmetro ObjUuid .

Especifique um valor de parâmetro de NULL para impedir o retorno de um tipo UUID. Dessa forma, um aplicativo pode determinar (do status retornado) se ObjUuid está registrado sem especificar uma variável UUID do tipo de saída.

Valor retornado

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

Comentários

Um aplicativo de servidor chama RpcObjectInqType para obter o tipo UUID de um objeto. Se o objeto tiver sido registrado com a biblioteca de tempo de execução RPC usando a função RpcObjectSetType , o tipo registrado será retornado.

Opcionalmente, um aplicativo pode manter um registro de objeto/tipo de forma privada. Nesse caso, se o aplicativo tiver fornecido uma função de investigação de objeto (consulte em RpcObjectSetInqFn). A biblioteca de tempo de execução RPC usa essa função para determinar o tipo de um objeto.

A função RpcObjectInqType obtém o tipo UUID, conforme descrito na tabela a seguir.

UUID do objeto
 
registrado		 Função inquiry
 
registrado		 Retorno
 
value
Sim ( RpcObjectSetType) Ignored UUID do tipo registrado do objeto.
No Sim ( RpcObjectSetInqFn) O tipo UUID retornado da função de consulta.
No No A UUID nula.
 
 

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

RpcObjectSetInqFn

RpcObjectSetType