Funzione RpcErrorAddRecord (rpcasync.h)
La funzione RpcErrorAddRecord aggiunge informazioni estese sugli errori a una catena di record di informazioni sugli errori estesi.
Sintassi
RPC_STATUS RpcErrorAddRecord(
[in] RPC_EXTENDED_ERROR_INFO *ErrorInfo
);
Parametri
[in] ErrorInfo
Informazioni sugli errori da aggiungere, sotto forma di struttura RPC_EXTENDED_ERROR_INFO .
Valore restituito
Il completamento riuscito restituisce RPC_S_OK.
Commenti
La funzione RpcErrorAddRecord consente alle applicazioni o ai server diversi dal runtime RPC di aggiungere informazioni estese sugli errori a una catena di record di informazioni sugli errori estesi.
La responsabilità delle stringhe a cui fa riferimento ErrorInfo appartiene al chiamante; La funzione RpcErrorAddRecord crea una copia di tali stringhe, se necessario. È necessario osservare le restrizioni seguenti sui membri di ErrorInfo :
La versione deve essere impostata su una versione valida, ad esempio RPC_EEINFO_VERSION.
ComputerName deve essere impostato su NULL. Qualsiasi altro valore restituisce ERROR_INVALID_PARAMETER.
ProcessID deve essere impostato su zero. Qualsiasi altro valore restituisce ERROR_INVALID_PARAMETER.
SystemTime o FileTime viene ignorato nell'input e viene impostato dal runtime RPC.
GenerateingComponent deve essere impostato su zero. Qualsiasi altro valore restituisce ERROR_INVALID_PARAMETER. Il runtime RPC imposta questo valore su EEInfoGCApplication.
Lo stato può essere impostato sul codice di errore che il chiamante vuole aggiungere alla catena.
DetectionLocation deve essere impostato su zero. Qualsiasi altro valore restituisce ERROR_INVALID_PARAMETER.
NumberOfParameters indica il numero di parametri nella matrice Parameters. Questo valore deve essere uguale o maggiore di zero o MaxNumberOfEEInfoParams. Il runtime RPC non usa memoria dopo il numero specificato di parametri, pertanto i chiamanti possono allocare in modo sicuro la memoria per meno dei parametri MaxNumberOfEEInfoParams.
I parametri rappresentano i parametri per il record di informazioni sugli errori esteso. L'unica restrizione per i parametri è che Pval viene usato per rappresentare i puntatori ed è sempre a 64 bit. Usare Pval indipendentemente dal fatto che il sistema usato sia a 32 bit o a 64 bit. Non usare Lval.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [app desktop | App UWP] |
| Server minimo supportato | Windows Server 2003 [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | rpcasync.h (include Rpc.h) |
| Libreria | Rpcrt4.lib |
| DLL | Rpcrt4.dll |