Funzione GetRestrictedErrorInfo (roerrorapi.h)

Articolo
03/01/2024

Ottiene l'oggetto informazioni sull'errore limitato impostato da una chiamata precedente a SetRestrictedErrorInfo nel thread logico corrente.

Sintassi

HRESULT GetRestrictedErrorInfo(
  [out] IRestrictedErrorInfo **ppRestrictedErrorInfo
);

Parametri

[out] ppRestrictedErrorInfo

Oggetto informazioni sull'errore limitato associato al thread corrente.

Valore restituito

Questa funzione può restituire uno di questi valori.

Codice restituito	Descrizione
S_OK	L'oggetto errore con restrizioni è stato recuperato correttamente.
S_FALSE	Non è presente alcun oggetto di errore limitato associato al thread corrente. Qualsiasi altro oggetto di errore viene rimosso dal thread.

Commenti

Chiamare la funzione GetRestrictedErrorInfo per ottenere l'oggetto IRestrictedErrorInfo impostato più di recente nel thread corrente in un'app di Windows Store.

Chiamare la funzione RoCaptureErrorContext per salvare le informazioni sugli errori per il thread corrente. Chiamare la funzione RoFailFastWithErrorContext per generare un'eccezione, terminare il processo corrente e segnalare l'errore al servizio Segnalazione errori Windows (WER).

GetRestrictedErrorInfo trasferisce la proprietà dell'oggetto errore al chiamante e cancella lo stato di errore per il thread. Se l'oggetto errore impostato più di recente non supporta l'interfaccia IRestrictedErrorInfo , lo stato di errore per il thread viene cancellato, ma non viene restituita alcuna interfaccia al chiamante.

GetRestrictedErrorInfo recupera l'oggetto errore dal thread corrente e chiama QueryInterface per trovare l'interfaccia IRestrictedErrorInfo. Se IRestrictedErrorInfo non viene trovato, GetRestrictedErrorInfo restituisce S_FALSE. In questo caso, l'oggetto error viene rimosso dal thread. Per altre informazioni, vedere GetErrorInfo.

La chiamata alla funzione GetRestrictedErrorInfo ha esito negativo se IRestrictedErrorInfo non è l'implementazione del sistema. Per creare un oggetto IRestrictedErrorInfo , chiamare le funzioni OriginError, TransformError o RoCaptureErrorContext .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2012 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	roerrorapi.h
DLL	Combase.dll