Función RpcMgmtEpUnregister (rpcdce.h)

Artículo
03/01/2024

[Esta función solo se admite en Windows NT y Windows Me/98/95; devuelve EP_S_CANT_PERFORM_OP en otras versiones de Windows.]

La función RpcMgmtEpUnregister quita la información de dirección del servidor de un mapa de punto de conexión.

Sintaxis

RPC_STATUS RpcMgmtEpUnregister(
  RPC_BINDING_HANDLE EpBinding,
  RPC_IF_ID          *IfId,
  RPC_BINDING_HANDLE Binding,
  UUID               *ObjectUuid
);

Parámetros

EpBinding

Host cuyos elementos de mapa de punto de conexión se van a anular el registro. Para quitar elementos del mismo host que la aplicación que llama, la aplicación especifica un valor null. Para quitar elementos de otro host, la aplicación especifica un identificador de enlace de servidor para cualquier servidor que resida en ese host. Tenga en cuenta que la aplicación puede especificar el mismo identificador de enlace que está usando para realizar otras llamadas a procedimientos remotos.

IfId

Identificador de interfaz que se va a quitar del mapa del punto de conexión.

Binding

Identificador de enlace que se va a quitar.

ObjectUuid

UUID de objeto opcional que se va a quitar. El valor NULL indica que no hay ningún UUID de objeto que se va a quitar.

Valor devuelto

Código devuelto	Descripción
RPC_S_OK	La llamada se realizó correctamente.
RPC_S_CANT_PERFORM_OP	No se puede realizar la operación solicitada.

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

Comentarios

La función RpcMgmtEpUnregister anula el registro de un elemento del mapa del punto de conexión. Un programa de administración llama a esta función para quitar direcciones de servidores que ya no están disponibles o para quitar direcciones de servidores que admiten objetos que ya no se ofrecen.

El parámetro EpBinding debe ser un enlace completo. El UUID de objeto asociado al parámetro EpBinding debe ser un UUID nulo. Especificar un UUID no nulo hace que la función produzca un error con el código de estado EPT_S_CANT_PERFORM_OP. Aparte de la información del host y el UUID del objeto, se omite toda la información de este argumento.

Una aplicación llama a RpcMgmtEpEltInqNext para ver los elementos de mapa de puntos de conexión locales. Después, la aplicación puede quitar los elementos mediante RpcMgmtEpUnregister.

Nota Use esta función con precaución. Quitar elementos de la asignación de punto de conexión local puede hacer que los servidores no estén disponibles para las aplicaciones cliente que aún no tienen un identificador de enlace totalmente enlazado al servidor.