Função RpcErrorAddRecord (rpcasync.h)
A função RpcErrorAddRecord adiciona informações de erro estendidas a uma cadeia de registros de informações de erro estendidos.
Sintaxe
RPC_STATUS RpcErrorAddRecord(
[in] RPC_EXTENDED_ERROR_INFO *ErrorInfo
);
Parâmetros
[in] ErrorInfo
Informações de erro a serem adicionadas, na forma de uma estrutura RPC_EXTENDED_ERROR_INFO .
Retornar valor
A conclusão bem-sucedida retorna RPC_S_OK.
Comentários
A função RpcErrorAddRecord permite que aplicativos ou servidores diferentes do RPC Runtime adicionem informações de erro estendidas a uma cadeia de registros de informações de erro estendidos.
A responsabilidade pelas cadeias de caracteres apontadas por ErrorInfo pertence ao chamador; A função RpcErrorAddRecord faz uma cópia dessas cadeias de caracteres, se necessário. As seguintes restrições aos membros de ErrorInfo devem ser observadas:
A versão deve ser definida como uma versão válida, como RPC_EEINFO_VERSION.
ComputerName deve ser definido como NULL. Qualquer outro valor resulta em ERROR_INVALID_PARAMETER.
ProcessID deve ser definido como zero. Qualquer outro valor resulta em ERROR_INVALID_PARAMETER.
SystemTime ou FileTime é ignorado na entrada e é definido pelo RPC Runtime.
GeneratingComponent deve ser definido como zero. Qualquer outro valor resulta em ERROR_INVALID_PARAMETER. O RPC Runtime define isso como EEInfoGCApplication.
O status pode ser definido como o código de erro que o chamador deseja adicionar à cadeia.
DetectionLocation deve ser definido como zero. Qualquer outro valor resulta em ERROR_INVALID_PARAMETER.
NumberOfParameters indica o número de parâmetros na matriz Parameters. Esse valor deve ser igual ou maior que zero ou MaxNumberOfEEInfoParams. O RPC Runtime não usa nenhuma memória após o número especificado de parâmetros, portanto, os chamadores podem alocar memória com segurança para menos de parâmetros MaxNumberOfEEInfoParams.
Os parâmetros representam os parâmetros para o registro de informações de erro estendido. A única restrição em Parameters é que Pval é usado para representar ponteiros e é sempre de 64 bits. Use Pval independentemente de o sistema usado ser de 32 bits ou 64 bits. Não use Lval.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [aplicativos da área de trabalho | aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | rpcasync.h (inclua Rpc.h) |
| Biblioteca | Rpcrt4.lib |
| DLL | Rpcrt4.dll |