Funzione RpcServerUnregisterIf (rpcdce.h)

Articolo
03/01/2024

La funzione RpcServerUnregisterIf rimuove un'interfaccia dal Registro di sistema della libreria di runtime RPC.

Sintassi

RPC_STATUS RpcServerUnregisterIf(
  RPC_IF_HANDLE IfSpec,
  UUID          *MgrTypeUuid,
  unsigned int  WaitForCallsToComplete
);

Parametri

IfSpec

Interfaccia da rimuovere dal Registro di sistema.

Specificare un valore Null per rimuovere tutte le interfacce registrate in precedenza con il valore UUID di tipo specificato nel parametro MgrTypeUuid .

MgrTypeUuid

Puntatore al tipo UUID del vettore del punto di ingresso del gestore (EPV) da rimuovere dal Registro di sistema. Il valore di MgrTypeUuid deve essere lo stesso valore fornito in una chiamata alla funzione RpcServerRegisterIf , alla funzione RpcServerRegisterIf2 o alla funzione RpcServerRegisterIfEx .

Specificare un valore Null per rimuovere l'interfaccia specificata nel parametro IfSpec per tutti gli UUID di tipo registrato in precedenza dal Registro di sistema.

Specificare un UUID nullo per rimuovere l'EPV del gestore predefinito generato da MIDL dal Registro di sistema. In questo caso, tutti gli EPV manager registrati con un UUID di tipo non nil rimangono registrati.

WaitForCallsToComplete

Flag che indica se rimuovere immediatamente l'interfaccia dal Registro di sistema o attendere il completamento di tutte le chiamate correnti.

Specificare il valore zero per ignorare le chiamate in corso e rimuovere immediatamente l'interfaccia dal Registro di sistema. Specificare qualsiasi valore diverso da zero per attendere il completamento di tutte le chiamate attive.

Valore restituito

Valore	Significato
RPC_S_OK	La chiamata ha avuto esito positivo.
RPC_S_UNKNOWN_MGR_TYPE	Il tipo di gestore è sconosciuto.
RPC_S_UNKNOWN_IF	L'interfaccia è sconosciuta.

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

Commenti

Un server chiama RpcServerUnregisterIf per rimuovere l'associazione tra un'interfaccia e un gestore EPV. Per specificare il gestore EPV da rimuovere nel parametro MgrTypeUuid , specificare il valore UUID di tipo specificato in una chiamata a RpcServerRegisterIf. Dopo la rimozione dal Registro di sistema, un'interfaccia non è più disponibile per le applicazioni client.

Quando un'interfaccia viene rimossa dal Registro di sistema, la libreria di runtime RPC smette di accettare nuove chiamate per tale interfaccia. Le chiamate attualmente in esecuzione nell'interfaccia possono essere completate, inclusi i callback.

La tabella seguente riepiloga il comportamento di RpcServerUnregisterIf.

IfSpec	MgrTypeUuid	Comportamento
Non Null	Non Null	Rimuove dal Registro di sistema il gestore EPV associato ai parametri specificati.
Non Null	NULL	Rimuove tutti gli EPV di gestione associati al parametro IfSpec .
NULL	Non Null	Rimuove tutti gli EPV di gestione associati al parametro MgrTypeUuid .
NULL	NULL	Rimuove tutti gli EPV di gestione. Questa chiamata ha l'effetto di impedire al server di ricevere nuove chiamate di routine remota perché tutti gli EPV di gestione per tutte le interfacce sono stati annullati.

Nota Se il valore di IfSpec è NULL, questa funzione lascerà registrate le interfacce di ascolto automatico . Le interfacce di ascolto automatico devono essere rimosse singolarmente dal Registro di sistema. Per altri dettagli , vedere 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