Função RpcServerUnregisterIfEx (rpcdce.h)

Artigo
08/25/2023

A função RpcServerUnregisterIfEx remove uma interface do registro de biblioteca em tempo de execução RPC. Essa função estende a funcionalidade da função RpcServerUnregisterIf .

Sintaxe

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

Parâmetros

[in] IfSpec

Interface a ser removida do registro.

Especifique um valor nulo para remover todas as interfaces registradas anteriormente com o valor UUID de tipo especificado no parâmetro MgrTypeUuid .

[in] MgrTypeUuid

Ponteiro para o tipo UUID do EPV (vetor de ponto de entrada) do gerenciador a ser removido do registro. O valor de MgrTypeUuid deve ser o mesmo valor que foi fornecido em uma chamada para a função RpcServerRegisterIf , a função RpcServerRegisterIf2 ou a função RpcServerRegisterIfEx .

Especifique um valor nulo para remover a interface especificada no parâmetro IfSpec para todos os UUIDs de tipo registrado anteriormente do registro.

Especifique uma UUID nula para remover o EPV do gerenciador padrão gerado por MIDL do registro. Nesse caso, todos os EPVs de gerente registrados com um UUID de tipo não nulo permanecem registrados.

[in] RundownContextHandles

Especifica se o rundown é chamado para identificadores de contexto ativos. Se não for zero, o rundown será chamado depois que todas as chamadas na interface forem concluídas. Se definido como zero, o tempo de execução do RPC pressupõe que o servidor já destruiu sua parte do identificador de contexto e não chamará as rotinas de rundown.

Retornar valor

Retorna status RPC. RpcServerUnregisterIfEx não falha, a menos que seja fornecido com valores inválidos.

Nota Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.

Comentários

A função RpcServerUnregisterIfEx aguarda que todas as chamadas em uma determinada interface sejam concluídas antes de cancelar o registro dos identificadores de contexto.

A função RpcServerUnregisterIfEx fornece toda a funcionalidade fornecida na função RpcServerUnregisterIf . Além disso, a função RpcServerUnregisterIfEx cancela o registro de todos os identificadores de contexto registrados pela interface fornecida. A interface deve usar o atributo strict_context_handle , caso contrário, os resultados são indefinidos.

RpcServerUnregisterIfEx é a única função que fornece o descarregamento seguro de uma DLL com identificadores de contexto ativos fora do desligamento do processo. Ele está disponível apenas no Windows XP e em versões posteriores do Windows.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	rpcdce.h (inclua Rpc.h)
Biblioteca	Rpcrt4.lib
DLL	Rpcrt4.dll