Funzione RpcObjectSetType (rpcdce.h)

Articolo
03/05/2024

La funzione RpcObjectSetType assegna il tipo di un oggetto .

Sintassi

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

Parametri

ObjUuid

Puntatore a un UUID dell'oggetto da associare al tipo UUID nel parametro TypeUuid .

TypeUuid

Puntatore al tipo UUID del parametro ObjUuid .

Specificare un valore di parametro NULL o un UUID nil per reimpostare il tipo di oggetto sull'associazione predefinita di UUID/nil-type UUID.

Valore restituito

Valore	Significato
RPC_S_OK	La chiamata ha avuto esito positivo.
RPC_S_INVALID_OBJECT	L'oggetto non è valido.
RPC_S_ALREADY_REGISTERED	L'oggetto è già registrato.
RPC_S_OUT_OF_MEMORY	Il sistema non è in memoria.

Nota Per un elenco di codici di errore validi, vedere Valori restituiti RPC.

Commenti

Un'applicazione server chiama RpcObjectSetType per assegnare un tipo UUID a un UUID oggetto. Per impostazione predefinita, la libreria di runtime RPC assegna automaticamente tutti gli UUID degli oggetti con l'UUID di tipo nil. Un'applicazione server che contiene un'implementazione di un'interfaccia (un vettore del punto di ingresso di gestione [EPV]) non deve chiamare RpcObjectSetType purché il server ha registrato l'interfaccia con l'UUID di tipo nil (vedere in RpcServerRegisterIf).

Un'applicazione server che contiene più implementazioni di un'interfaccia ,ovvero più EPV di gestione, ovvero più UUID di tipo multipli, chiama RpcObjectSetType una volta per ogni diverso UUID di tipo UUID/diverso da UUID di tipo UUID supportato dal server. L'associazione di ogni oggetto a un UUID di tipo indica alla libreria di runtime RPC quale gestore EPV (implementazione dell'interfaccia) utilizzare quando il server riceve una chiamata di procedura remota per un UUID oggetto non nil.

La libreria di runtime RPC consente a un'applicazione di impostare il tipo per un numero illimitato di oggetti. Per rimuovere l'associazione tra un UUID di un oggetto e il relativo tipo UUID (stabilito chiamando RpcObjectSetType), un server chiama nuovamente RpcObjectSetType , specificando un valore Null o un UUID nil per il parametro TypeUuid . In questo modo l'associazione UUID/type UUID dell'oggetto viene reimpostata sull'associazione predefinita UUID/UUID di tipo NIL. Un server non può assegnare un tipo all'UUID dell'oggetto nil. La libreria di runtime RPC assegna automaticamente l'UUID dell'oggetto nil a un UUID di tipo nil.

Per informazioni dettagliate, vedere Registrazione delle interfacce.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	rpcdce.h (include Rpc.h)
Libreria	Rpcrt4.lib
DLL	Rpcrt4.dll

Vedi anche

Registrazione delle interfacce

RpcServerRegisterIf

Condividi tramite