RPC_MGMT_AUTHORIZATION_FN función de devolución de llamada (rpcdce.h)

  • Artículo

El RPC_MGMT_AUTHORIZATION_FN permite a los programas de servidor implementar técnicas de autorización RPC personalizadas.

Sintaxis

RPC_MGMT_AUTHORIZATION_FN RpcMgmtAuthorizationFn;

int RpcMgmtAuthorizationFn(
  RPC_BINDING_HANDLE ClientBinding,
  unsigned long RequestedMgmtOperation,
  RPC_STATUS *Status
)
{...}

Parámetros

ClientBinding

Identificador de enlace de cliente/servidor.

RequestedMgmtOperation

El valor de RequestedMgmtOperation depende de la función remota solicitada, como se muestra en la tabla siguiente.

Llamada función remota Significado
RpcMgmtInqIfIds
 RPC_C_MGMT_INQ_IF_IDS
RpcMgmtInqServerPrincName
 RPC_C_MGMT_INQ_PRINC_NAME
RpcMgmtInqStats
 RPC_C_MGMT_INQ_STATS
RpcMgmtIsServerListening
 RPC_C_MGMT_IS_SERVER_LISTEN
RpcMgmtStopServerListening
 RPC_C_MGMT_STOP_SERVER_LISTEN
 

La función de autorización debe controlar todos estos valores.

Status

Si Status es 0 (cero) o RPC_S_OK, la función de administración remota devuelve el valor Status RPC_S_ACCESS_DENIED al cliente. Si la función de autorización devuelve cualquier otro valor para Status, la función de administración remota devuelve ese valor status al cliente.

Valor devuelto

Devuelve TRUE si se permite el acceso del cliente que realiza la llamada a la función de administración solicitada. Si la función de autorización devuelve FALSE, la función de administración no se puede ejecutar. En este caso, la función devuelve un valor Status al cliente:

Comentarios

Cuando un cliente solicita una de las funciones de administración remota del servidor, la biblioteca en tiempo de ejecución del servidor llama a la función de autorización con ClientBinding y RequestedMgmtOperation. La función de autorización usa estos parámetros para determinar si el cliente que realiza la llamada puede ejecutar la función de administración solicitada.

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

Consulte también

Funciones de autorización

RpcMgmtSetAuthorizationFn