RpcObjectSetType, fonction (rpcdce.h)

La fonction RpcObjectSetType affecte le type d’un objet .

Syntaxe

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

Paramètres

ObjUuid

Pointeur vers un UUID d’objet à associer au type UUID dans le paramètre TypeUuid .

TypeUuid

Pointeur vers le type UUID du paramètre ObjUuid .

Spécifiez une valeur de paramètre NULL ou un UUID nil pour réinitialiser le type d’objet à l’association par défaut de l’UUID d’objet/UUID de type nil.

Valeur retournée

Remarques

Une application serveur appelle RpcObjectSetType pour affecter un type UUID à un UUID d’objet. Par défaut, la bibliothèque d’exécution RPC affecte automatiquement tous les UUID d’objets avec l’UUID de type nil. Une application serveur qui contient une implémentation d’une interface (un vecteur de point d’entrée de gestionnaire [EPV]) n’a pas besoin d’appeler RpcObjectSetType , à condition que le serveur ait inscrit l’interface avec l’UUID de type nil (voir sous RpcServerRegisterIf).

Une application serveur qui contient plusieurs implémentations d’une interface (plusieurs EPV de gestionnaire, c’est-à-dire plusieurs UUID de type) appelle RpcObjectSetType une fois pour chaque association UUID/non nil de type UUID d’objet que le serveur prend en charge. L’association de chaque objet à un type UUID indique à la bibliothèque d’exécution RPC le gestionnaire EPV (implémentation d’interface) à utiliser lorsque le serveur reçoit un appel de procédure distante pour un UUID d’objet non nil.

La bibliothèque d’exécution RPC permet à une application de définir le type d’un nombre illimité d’objets. Pour supprimer l’association entre un UUID d’objet et son type UUID (établi en appelant RpcObjectSetType), un serveur appelle à nouveau RpcObjectSetType , en spécifiant une valeur Null ou un UUID nil pour le paramètre TypeUuid . Cela réinitialise l’association UUID/type UUID de l’objet à l’association par défaut de l’UUID de type UUID/nil-type d’objet. Un serveur ne peut pas attribuer un type à l’UUID de l’objet nil. La bibliothèque d’exécution RPC affecte automatiquement à l’UUID de l’objet nil un UUID de type nil.

Pour plus d’informations, consultez Inscription d’interfaces.

Configuration requise

Voir aussi

Inscription d’interfaces

RpcServerRegisterIf