Función RpcErrorAddRecord (rpcasync.h)

  • Artículo

La función RpcErrorAddRecord agrega información de error extendida a una cadena de registros de información de errores extendidos.

Sintaxis

RPC_STATUS RpcErrorAddRecord(
  [in] RPC_EXTENDED_ERROR_INFO *ErrorInfo
);

Parámetros

[in] ErrorInfo

Información de error que se va a agregar, en forma de estructura RPC_EXTENDED_ERROR_INFO .

Valor devuelto

La finalización correcta devuelve RPC_S_OK.

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

Comentarios

La función RpcErrorAddRecord permite a las aplicaciones o servidores distintos del tiempo de ejecución de RPC agregar información de error extendida a una cadena de registros de información de errores extendidos.

La responsabilidad de las cadenas a las que apunta ErrorInfo pertenece al autor de la llamada; La función RpcErrorAddRecord realiza una copia de esas cadenas, si es necesario. Se deben observar las siguientes restricciones en los miembros de ErrorInfo :

La versión debe establecerse en una versión válida, como RPC_EEINFO_VERSION.

NombreDeEquipo debe establecerse en NULL. Cualquier otro valor da como resultado ERROR_INVALID_PARAMETER.

ProcessID debe establecerse en cero. Cualquier otro valor da como resultado ERROR_INVALID_PARAMETER.

SystemTime o FileTime se omite en la entrada y lo establece el tiempo de ejecución de RPC.

GenerarComponent debe establecerse en cero. Cualquier otro valor da como resultado ERROR_INVALID_PARAMETER. Rpc Runtime establece esto en EEInfoGCApplication.

El estado se puede establecer en el código de error que el autor de la llamada quiere agregar a la cadena.

DetectionLocation debe establecerse en cero. Cualquier otro valor da como resultado ERROR_INVALID_PARAMETER.

NumberOfParameters indica el número de parámetros de la matriz Parameters. Este valor debe ser igual o mayor que cero o MaxNumberOfEEInfoParams. El tiempo de ejecución de RPC no usa ninguna memoria después del número especificado de parámetros, por lo que los llamadores pueden asignar memoria de forma segura para menos de los parámetros MaxNumberOfEEInfoParams.

Los parámetros representan los parámetros del registro de información de error extendido. La única restricción en Parameters es que Pval se usa para representar punteros y siempre es de 64 bits. Use Pval independientemente de si el sistema utilizado es de 32 o 64 bits. No use Lval.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2003 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado rpcasync.h (incluir Rpc.h)
Library Rpcrt4.lib
Archivo DLL Rpcrt4.dll

Consulte también

Obtención de información de error de RPC extendida

RPC_EXTENDED_ERROR_INFO

RpcErrorGetNextRecord

RpcErrorStartEnumeration