Função RpcObjectSetType (rpcdce.h)

  • Artigo

A função RpcObjectSetType atribui o tipo de um objeto .

Sintaxe

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

Parâmetros

ObjUuid

Ponteiro para um objeto UUID a ser associado ao tipo UUID no parâmetro TypeUuid .

TypeUuid

Ponteiro para o tipo UUID do parâmetro ObjUuid .

Especifique um valor de parâmetro de NULL ou um UUID nulo para redefinir o tipo de objeto para a associação padrão do objeto UUID/UUID do tipo nil.

Valor retornado

Valor Significado
RPC_S_OK
 A chamada foi bem-sucedida.
RPC_S_INVALID_OBJECT
 O objeto é inválido.
RPC_S_ALREADY_REGISTERED
 O objeto já está registrado.
RPC_S_OUT_OF_MEMORY
 O sistema está sem memória.
 
Nota Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.
 

Comentários

Um aplicativo de servidor chama RpcObjectSetType para atribuir um UUID de tipo a um objeto UUID. Por padrão, a biblioteca de tempo de execução RPC atribui automaticamente todos os UUIDs de objeto com o UUID do tipo zero. Um aplicativo de servidor que contém uma implementação de uma interface (um vetor de ponto de entrada do gerenciador [EPV]) não precisa chamar RpcObjectSetType desde que o servidor tenha registrado a interface com a UUID de tipo zero (consulte em RpcServerRegisterIf).

Um aplicativo de servidor que contém várias implementações de uma interface (vários EPVs de gerenciador— ou seja, UUIDs de vários tipos) chama RpcObjectSetType uma vez para cada UUID de objeto diferente/associação UUID de tipo não nulo que o servidor dá suporte. Associar cada objeto a um UUID de tipo informa à biblioteca de tempo de execução RPC qual EPV do gerenciador (implementação de interface) usar quando o servidor recebe uma chamada de procedimento remoto para um UUID de objeto não nulo.

A biblioteca de tempo de execução RPC permite que um aplicativo defina o tipo para um número ilimitado de objetos. Para remover a associação entre um objeto UUID e seu tipo UUID (estabelecido chamando RpcObjectSetType), um servidor chama RpcObjectSetType novamente, especificando um valor nulo ou um UUID nulo para o parâmetro TypeUuid . Isso redefine a associação UUID/tipo UUID do objeto para a associação padrão do UUID do objeto/UUID do tipo nil. Um servidor não pode atribuir um tipo ao UUID do objeto nulo. A biblioteca de tempo de execução RPC atribui automaticamente o UUID de objeto nulo a um UUID de tipo nulo.

Para obter informações detalhadas, consulte Registrando interfaces.

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

Registrando interfaces

RpcServerRegisterIf