PFN_WER_RUNTIME_EXCEPTION_EVENT_SIGNATURE funzione di callback (werapi.h)

Articolo
03/03/2024

Segnalazione errori Windows (WER) chiama questa funzione per ottenere i parametri del report che descrivono in modo univoco il problema.

Il tipo PFN_WER_RUNTIME_EXCEPTION_EVENT_SIGNATURE definisce un puntatore a questa funzione di callback. È necessario usare "OutOfProcessExceptionEventSignatureCallback" come nome della funzione di callback.

Sintassi

PFN_WER_RUNTIME_EXCEPTION_EVENT_SIGNATURE PfnWerRuntimeExceptionEventSignature;

HRESULT PfnWerRuntimeExceptionEventSignature(
  [in]      PVOID pContext,
  [in]      const PWER_RUNTIME_EXCEPTION_INFORMATION pExceptionInformation,
  [in]      DWORD dwIndex,
  [out]     PWSTR pwszName,
  [in, out] PDWORD pchName,
  [out]     PWSTR pwszValue,
  [in, out] PDWORD pchValue
)
{...}

Parametri

[in] pContext

Puntatore a informazioni di contesto arbitrarie specificate quando si chiama la funzione WerRegisterRuntimeExceptionModule per registrare il gestore eccezioni .

[in] pExceptionInformation

Struttura WER_RUNTIME_EXCEPTION_INFORMATION contenente le informazioni sull'eccezione.

[in] dwIndex

Indice del parametro del report. I valori validi sono da 0 a 9. La prima chiamata a questa funzione deve impostare l'indice su 0 e ogni chiamata successiva deve aumentare il valore dell'indice in sequenza.

[out] pwszName

Buffer allocato dal chiamante usato per specificare il nome del parametro.

[in, out] pchName

Dimensioni, in caratteri, del buffer pwszName . Le dimensioni includono il carattere null-terminazione.

[out] pwszValue

Buffer allocato dal chiamante usato per specificare il valore del parametro.

[in, out] pchValue

Dimensioni, in caratteri, del buffer pwszValue . Le dimensioni includono il carattere null-terminazione.

Valore restituito

Restituire S_OK sull'esito positivo. Se si restituiscono altri codici di errore, WER ripristina il comportamento predefinito per la segnalazione degli arresti anomali.

Commenti

È necessario implementare questa funzione nella DLL del gestore eccezioni.

Per generare report di errore per problemi specifici dell'applicazione, l'applicazione deve creare una breve descrizione del problema usando alcune informazioni di base denominate parametri del report. I parametri del report includono informazioni quali il nome dell'applicazione, la versione dell'applicazione, il nome del modulo, la versione del modulo e il codice di errore. La combinazione di questi parametri del report descrive un problema univoco.

WER chiama questa funzione di callback solo se si imposta il parametro pbOwnershipClaimed della funzione di callback OutOfProcessExceptionEventCallback su TRUE. Il parametro pdwSignatureCount di OutOfProcessExceptionEventCallback determina il numero di volte in cui WER chiamerà questa funzione di callback.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	werapi.h

Vedi anche

WerRegisterRuntimeExceptionModule, Segnalazione errori Windows

Condividi tramite