RpcObjectSetType, fonction (rpcdce.h)

Article
03/04/2024

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

Valeur	Signification
RPC_S_OK	L’appel a réussi.
RPC_S_INVALID_OBJECT	L’objet n’est pas valide.
RPC_S_ALREADY_REGISTERED	L’objet est déjà inscrit.
RPC_S_OUT_OF_MEMORY	Le système est en mémoire insuffisante.

Note Pour obtenir la liste des codes d’erreur valides, consultez Valeurs de retour RPC.

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

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	rpcdce.h (inclure Rpc.h)
Bibliothèque	Rpcrt4.lib
DLL	Rpcrt4.dll

Voir aussi

Inscription d’interfaces

RpcServerRegisterIf

Partager via