Función RpcServerUnregisterIfEx (rpcdce.h)
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.
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 |