Función RpcMgmtSetAuthorizationFn (rpcdce.h)

Artículo
03/15/2023

La función RpcMgmtSetAuthorizationFn establece una función de autorización para procesar llamadas remotas a las funciones de administración de un servidor.

Sintaxis

RPC_STATUS RpcMgmtSetAuthorizationFn(
  RPC_MGMT_AUTHORIZATION_FN AuthorizationFn
);

Parámetros

AuthorizationFn

Especifica una función de autorización. La biblioteca en tiempo de ejecución del servidor RPC llama automáticamente a esta función cada vez que el servidor recibe una solicitud de cliente para ejecutar una de las funciones de administración remota. El servidor debe implementar esta función. Las aplicaciones especifican un valor NULL para anular el registro de una función de autorización registrada anteriormente. Después de esta llamada, se usan las autorizaciones predeterminadas.

Valor devuelto

Valor	Significado
RPC_S_OK	La llamada se realizó correctamente.

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

Comentarios

Las aplicaciones de servidor llaman a la función RpcMgmtSetAuthorizationFn para establecer una función de autorización que controla el acceso a las funciones de administración remota del servidor. Cuando un servidor no ha llamado a RpcMgmtSetAuthorizationFn o llama a con un valor NULL para AuthorizationFn, la biblioteca en tiempo de ejecución del servidor usa las siguientes autorizaciones predeterminadas.

Función remota	Autorización predeterminada
RpcMgmtInqIfIds	habilitado
RpcMgmtInqServerPrincName	habilitado
RpcMgmtInqStats	habilitado
RpcMgmtIsServerListening	habilitado
RpcMgmtStopServerListening	Disabled

En la tabla anterior, "Enabled" indica que todos los clientes pueden ejecutar la función remota y "Disabled" indica que se impide que todos los clientes ejecuten la función remota.

Requisitos

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