Funzione RpcServerUnregisterIfEx (rpcdce.h)

Articolo
08/25/2023

La funzione RpcServerUnregisterIfEx rimuove un'interfaccia dal Registro di sistema della libreria di runtime RPC. Questa funzione estende la funzionalità della funzione RpcServerUnregisterIf .

Sintassi

RPC_STATUS RpcServerUnregisterIfEx(
  [in] RPC_IF_HANDLE IfSpec,
  [in] UUID          *MgrTypeUuid,
  [in] int           RundownContextHandles
);

Parametri

[in] 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 .

[in] 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.

[in] RundownContextHandles

Specifica se il rundown viene chiamato per gli handle di contesto attivi. Se diverso da zero, il rundown viene chiamato una volta completate tutte le chiamate sull'interfaccia. Se impostato su zero, il tempo di esecuzione RPC presuppone che il server abbia già eliminato la parte dell'handle di contesto e non chiamerà le routine di rundown.

Valore restituito

Restituisce lo stato RPC. RpcServerUnregisterIfEx non riesce a meno che non venga fornito con valori non validi.

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

Commenti

La funzione RpcServerUnregisterIfEx attende il completamento di tutte le chiamate su una determinata interfaccia prima di annullare la registrazione degli handle di contesto.

La funzione RpcServerUnregisterIfEx fornisce tutte le funzionalità fornite nella funzione RpcServerUnregisterIf . Inoltre, la funzione RpcServerUnregisterIfEx annulla la registrazione di tutti gli handle di contesto registrati dall'interfaccia specificata. L'interfaccia deve usare l'attributo strict_context_handle ; in caso contrario, i risultati non sono definiti.

RpcServerUnregisterIfEx è l'unica funzione che fornisce lo scaricamento sicuro di una DLL con handle di contesto attivi all'esterno dell'arresto del processo. È disponibile solo in Windows XP e versioni successive di Windows.

Requisiti

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