RpcErrorAddRecord, fonction (rpcasync.h)
La fonction RpcErrorAddRecord ajoute des informations d’erreur étendues à une chaîne d’enregistrements d’informations d’erreur étendus.
Syntaxe
RPC_STATUS RpcErrorAddRecord(
[in] RPC_EXTENDED_ERROR_INFO *ErrorInfo
);
Paramètres
[in] ErrorInfo
Informations d’erreur à ajouter, sous la forme d’une structure de RPC_EXTENDED_ERROR_INFO .
Valeur retournée
L’achèvement réussi retourne RPC_S_OK.
Remarques
La fonction RpcErrorAddRecord permet aux applications ou serveurs autres que le runtime RPC d’ajouter des informations d’erreur étendues à une chaîne d’enregistrements d’informations d’erreur étendus.
La responsabilité des chaînes pointées par ErrorInfo appartient à l’appelant ; La fonction RpcErrorAddRecord effectue une copie de ces chaînes, si nécessaire. Les restrictions suivantes sur les membres d’ErrorInfo doivent être respectées :
Version doit être définie sur une version valide, telle que RPC_EEINFO_VERSION.
ComputerName doit être défini sur NULL. Toute autre valeur entraîne ERROR_INVALID_PARAMETER.
ProcessID doit être défini sur zéro. Toute autre valeur entraîne ERROR_INVALID_PARAMETER.
SystemTime ou FileTime est ignoré lors de l’entrée et est défini par le runtime RPC.
GeneratingComponent doit être défini sur zéro. Toute autre valeur entraîne ERROR_INVALID_PARAMETER. Le runtime RPC définit ce paramètre sur EEInfoGCApplication.
L’état peut être défini sur le code d’erreur que l’appelant souhaite ajouter à la chaîne.
DetectionLocation doit être défini sur zéro. Toute autre valeur entraîne ERROR_INVALID_PARAMETER.
NumberOfParameters indique le nombre de paramètres dans le tableau Parameters. Cette valeur doit être égale ou supérieure à zéro ou MaxNumberOfEEInfoParams. Le runtime RPC n’utilise pas de mémoire après le nombre spécifié de paramètres, de sorte que les appelants peuvent allouer de la mémoire en toute sécurité pour moins de paramètres MaxNumberOfEEInfoParams.
Parameters représente les paramètres de l’enregistrement d’informations d’erreur étendu. La seule restriction sur Parameters est que Pval est utilisé pour représenter les pointeurs et est toujours de 64 bits. Utilisez Pval , que le système utilisé soit 32 bits ou 64 bits. N’utilisez pas Lval.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP [applications de bureau | applications UWP] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau | applications UWP] |
| Plateforme cible | Windows |
| En-tête | rpcasync.h (inclure Rpc.h) |
| Bibliothèque | Rpcrt4.lib |
| DLL | Rpcrt4.dll |