Función RpcServerUnregisterIfEx (rpcdce.h)

Artículo
03/05/2024

La función RpcServerUnregisterIfEx quita una interfaz del registro de biblioteca en tiempo de ejecución rpc. Esta función amplía la funcionalidad de la función RpcServerUnregisterIf .

Sintaxis

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

Parámetros

[in] IfSpec

Interfaz que se va a quitar del registro.

Especifique un valor NULL para quitar todas las interfaces registradas anteriormente con el valor UUID de tipo especificado en el parámetro MgrTypeUuid .

[in] MgrTypeUuid

Puntero al tipo UUID del vector de punto de entrada del administrador (EPV) que se va a quitar del registro. El valor de MgrTypeUuid debe ser el mismo que se proporcionó en una llamada a la función RpcServerRegisterIf , rpcServerRegisterIf2 o a la función RpcServerRegisterIfEx .

Especifique un valor NULL para quitar la interfaz especificada en el parámetro IfSpec para todos los UUID de tipo registrados anteriormente del registro.

Especifique un UUID nulo para quitar el administrador predeterminado EPV generado por MIDL del registro. En este caso, todos los EPV de administrador registrados con un UUID de tipo no nulo permanecen registrados.

[in] RundownContextHandles

Especifica si se llama a la lista desplegable para los identificadores de contexto activos. Si no es cero, se llama a la lista desplegable una vez completadas todas las llamadas en la interfaz. Si se establece en cero, el tiempo de ejecución de RPC supone que el servidor ya ha destruido su parte del identificador de contexto y no llamará a las rutinas de detención.

Valor devuelto

Devuelve el estado rpc. RpcServerUnregisterIfEx no produce un error a menos que se proporcione con valores no válidos.

Nota Para obtener una lista de códigos de error válidos, consulte Rpc Return Values.

Comentarios

La función RpcServerUnregisterIfEx espera a que todas las llamadas de una interfaz determinada se completen antes de anular el registro de los identificadores de contexto.

La función RpcServerUnregisterIfEx proporciona toda la funcionalidad proporcionada en la función RpcServerUnregisterIf . Además, la función RpcServerUnregisterIfEx anula el registro de todos los identificadores de contexto registrados por la interfaz especificada. La interfaz debe usar el atributo strict_context_handle ; de lo contrario, los resultados no están definidos.

RpcServerUnregisterIfEx es la única función que proporciona una descarga segura de un archivo DLL con identificadores de contexto activos fuera del apagado del proceso. Solo está disponible en Windows XP y versiones posteriores de Windows.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	rpcdce.h (incluir Rpc.h)
Library	Rpcrt4.lib
Archivo DLL	Rpcrt4.dll