Funzione RpcServerRegisterIf (rpcdce.h)

Articolo
03/05/2024

La funzione RpcServerRegisterIf registra un'interfaccia con la libreria di runtime RPC.

Sintassi

RPC_STATUS RpcServerRegisterIf(
  RPC_IF_HANDLE IfSpec,
  UUID          *MgrTypeUuid,
  RPC_MGR_EPV   *MgrEpv
);

Parametri

IfSpec

Struttura generata da MIDL che indica l'interfaccia da registrare.

MgrTypeUuid

Puntatore a un tipo UUID da associare al parametro MgrEpv . Specificando un valore di parametro Null (o un UUID nil) registra IfSpec con un UUID di tipo nil.

MgrEpv

Vettore del punto di ingresso (EPV) della routine di Gestione. Per usare l'EPV predefinito generato da MIDL, specificare un valore Null. Per altre informazioni, vedere RPC_MGR_EPV.

Valore restituito

Restituisce RPC_S_OK al termine dell'esito positivo.

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

Commenti

Un server può registrare un numero illimitato di interfacce con la libreria di runtime RPC. La registrazione rende disponibile un'interfaccia ai client usando un handle di associazione al server. Per registrare un'interfaccia, il codice dell'applicazione server chiama RpcServerRegisterIf. Per ogni implementazione di un'interfaccia offerta da un server, deve registrare un EPV di gestione separato.

Quando si chiama RpcServerRegisterIf, il server fornisce le informazioni seguenti:

Specifica dell'interfaccia
La specifica dell'interfaccia è una struttura di dati generata dal compilatore MIDL. Il server specifica l'interfaccia usando il parametro IfSpec .
Tipo di gestione UUID e gestione EPV
Il tipo di gestione UUID e il gestore EPV determinano la routine di gestione eseguita quando un server riceve una richiesta di chiamata di procedura remota da un client.

Il server specifica il tipo di gestione UUID e EPV usando i parametri MgrTypeUuid e MgrEpv . Si noti che quando si specifica un UUID di tipo non nil manager, il server deve anche chiamare la funzione RpcObjectSetType per registrare gli oggetti di questo tipo non nil.

Se l'applicazione server deve registrare un'interfaccia di ascolto automatico o usare una funzione di callback a scopo di autenticazione, usare RpcServerRegisterIfEx.

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