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.

Nota Per un elenco di codici di errore validi, vedere Valori restituiti RPC.

 

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

Vedi anche

Recupero delle informazioni sugli errori RPC estese

RPC_EXTENDED_ERROR_INFO

RpcErrorGetNextRecord

RpcErrorStartEnumeration