Función RpcServerInqCallAttributesW (rpcasync.h)

La función RpcServerInqCallAttributes es una llamada de servidor RPC que obtiene atributos de contexto de seguridad de cliente.

Sintaxis

RPC_STATUS RpcServerInqCallAttributesW(
  [in]      RPC_BINDING_HANDLE ClientBinding,
  [in, out] void               *RpcCallAttributes
);

Parámetros

[in] ClientBinding

Opcional. Para el enlace explícito dentro de una rutina de servidor, clientBinding es el identificador de enlace con el que se llamó a la rutina de administrador. Vea comentarios.

[in, out] RpcCallAttributes

RPC_CALL_ATTRIBUTES_V2 estructura que recibe atributos de llamada.

Valor devuelto

Devuelve RPC_S_OK tras éxito y se rellenan los RpcCallAttributes. Si se devuelve ERROR_MORE_DATA, uno o varios campos de RpcCallAttributes tenían una longitud insuficiente y no se pudieron rellenar. Consulte Comentarios en RPC_CALL_ATTRIBUTES_V2 para obtener más información sobre el control de ERROR_MORE_DATA.

Tras un error, el contenido de RpcCallAttributes no está definido y puede modificarse parcialmente por RPC.

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

 

Observaciones

La función rpcServerInqCallAttributes usa un esquema de control de versiones para incorporar nuevas funcionalidades sin tener que introducir nuevas funciones con identificadores de sufijo. Por ejemplo, una segunda versión del RPC_CALL_ATTRIBUTES_V2, identificada con un #define simple en el encabezado, puede agregar nuevos miembros para facilitar nuevas funciones integradas en versiones futuras de la función RpcServerInqCallAttributes, sin tener que liberar una función llamada RpcServerInqCallAttributesEx.

Si se llama a la función RpcServerInqCallAttributes fuera de una rutina de servidor y, si la llamada de función consulta los atributos de contexto de seguridad para una llamada RPC asincrónica, se puede recuperar clientBinding llamando a la función RpcAsyncGetCallHand le desde el identificador asincrónico.

La función RpcServerInqCallAttributes no se admite para secuencias de protocolo de datagrama, como ncadg_*. Si se invoca en una llamada que se ejecuta en una secuencia de protocolo de datagrama, se devuelve RPC_S_CANNOT_SUPPORT.

La función rpcServerInqCallAttributes es segura para subprocesos.

Ejemplos

RPC_CALL_ATTRIBUTES CallAttributes;  // this maps to RPC_CALL_ATTRIBUTES_V1

memset(&CallAttributes, 0, sizeof(CallAttributes));
CallAttributes.Version = RPC_CALL_ATTRIBUTES_VERSION;    // maps to 1
CallAttributes.Flags = ;//....
Status = RpcServerInqCallAttributes(0, &ClientContextAttributes);

Nota

El encabezado rpcasync.h define RpcServerInqCallAttributes como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	rpcasync.h (incluya Rpc.h)
biblioteca de	Rpcrt4.lib
DLL de	Rpcrt4.dll

Consulte también

RPC_CALL_ATTRIBUTES_V2

RpcAsyncGetCallHandle