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.

Nota Para obter uma lista de códigos de erro válidos, consulte RPC Return Values.

 

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

Confira também

Obtendo informações de erro de RPC estendidas

RPC_EXTENDED_ERROR_INFO

RpcErrorGetNextRecord

RpcErrorStartEnumeration