Función RpcObjectSetType (rpcdce.h)

La función RpcObjectSetType asigna el tipo de un objeto.

Sintaxis

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

Parámetros

ObjUuid

Puntero a un UUID de objeto que se va a asociar al tipo UUID en el parámetro TypeUuid .

TypeUuid

Puntero al tipo UUID del parámetro ObjUuid .

Especifique un valor de parámetro de NULL o un UUID nulo para restablecer el tipo de objeto a la asociación predeterminada de UUID de objeto/UUID de tipo nulo.

Valor devuelto

Valor	Significado
RPC_S_OK	La llamada se realizó correctamente.
RPC_S_INVALID_OBJECT	El objeto no es válido.
RPC_S_ALREADY_REGISTERED	El objeto ya está registrado.
RPC_S_OUT_OF_MEMORY	El sistema está sin memoria.

 

Nota Para obtener una lista de códigos de error válidos, vea Rpc Return Values.

 

Comentarios

Una aplicación de servidor llama a RpcObjectSetType para asignar un UUID de tipo a un UUID de objeto. De forma predeterminada, la biblioteca en tiempo de ejecución rpc asigna automáticamente todos los UUID de objeto con el UUID de tipo nulo. Una aplicación de servidor que contiene una implementación de una interfaz (un vector de punto de entrada de administrador [EPV]) no necesita llamar a RpcObjectSetType siempre que el servidor registró la interfaz con el UUID de tipo nulo (consulte en RpcServerRegisterIf).

Una aplicación de servidor que contiene varias implementaciones de una interfaz (varios EPV de administrador, es decir, varios UUID de tipo) llama a RpcObjectSetType una vez para cada tipo UUID de objeto diferente o asociación de UUID de tipo no nulo que admite el servidor. La asociación de cada objeto con un UUID de tipo indica a la biblioteca en tiempo de ejecución rpc qué administrador EPV (implementación de interfaz) se usará cuando el servidor recibe una llamada de procedimiento remoto para un UUID de objeto no nulo.

La biblioteca en tiempo de ejecución rpc permite a una aplicación establecer el tipo para un número ilimitado de objetos. Para quitar la asociación entre un UUID de objeto y su UUID de tipo (establecido llamando a RpcObjectSetType), un servidor llama a RpcObjectSetType de nuevo, especificando un valor NULL o un UUID nulo para el parámetro TypeUuid . Esto restablece la asociación UUID/type UUID del objeto a la asociación predeterminada de UUID/nil-type UUID del objeto. Un servidor no puede asignar un tipo al UUID del objeto nulo. La biblioteca en tiempo de ejecución rpc asigna automáticamente el UUID de objeto nulo un UUID de tipo nulo.

Para obtener información detallada, vea Registrar interfaces.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	rpcdce.h (include Rpc.h)
Library	Rpcrt4.lib
Archivo DLL	Rpcrt4.dll

Consulte también

Registrar interfaces

RpcServerRegisterIf