Condividi tramite

Funzione JetGetErrorInfoW

  • Articolo

Si applica a: Windows | Windows Server

Funzione JetGetErrorInfoW

La funzione JetGetErrorInfoW BAS_ del motore di database.

Nota: questa documentazione si basa su una versione preliminare del motore di archiviazione estendibile. Queste informazioni sono soggette a modifiche.

JET_ERR JET_API JetGetErrorInfoW( 
    _In_opt_ void *                      pvContext, 
    _Out_writes_bytes_( cbMax ) void *   pvResult, 
    _In_ unsigned long                   cbMax, 
    _In_ unsigned long                   InfoLevel, 
    _In_ JET_GRBIT                       grbit );

Parametri

pvContext

Valore di contesto o di errore per il quale sono necessarie le informazioni sull'errore estese. Il valore passato dipende dal valore del parametro InfoLevel .

pvResult

Puntatore a un buffer che riceverà le informazioni. Il tipo del buffer dipende dal valore del parametro InfoLevel . Il chiamante deve essere configurato per allineare il buffer in modo appropriato.

cbMax

Dimensione massima della struttura pvResult passata.

InfoLevel

Il tipo di informazioni che verranno recuperate per le informazioni/contesto di errore viene specificato dal parametro pvContext . Il formato dei dati archiviati in pvResult dipende da InfoLevel.

Nella tabella seguente sono elencati i valori possibili per questo parametro.

Valore

Significato

JET_ErrorInfoSpecificErr

pvContext viene interpretato come codice JET_ERR/errore, pvResult viene interpretato come un JET_ERRINFOBASIC_W e i campi della struttura JET_ERRINFOBASIC_W vengono compilati in modo appropriato.

grbit

Riservato.

Valore restituito

Questa funzione restituisce il tipo di dati JET_ERR con uno dei codici restituiti elencati nella tabella seguente. Per altre informazioni sui possibili errori ESE, vedere Errori del motore di archiviazione estendibile e parametri di gestione degli errori.

Codice restituito

Descrizione

JET_errSuccess

Operazione riuscita.

JET_errInvalidParameter

Uno dei parametri forniti contiene un valore imprevisto o contiene un valore che non ha senso se combinato con il valore di un altro parametro. Questo problema può verificarsi per JetGetErrorInfo quando si verifica quanto segue:

  • Il valore del parametro InfoLevel specificato non è valido.

  • Il valore grbit specificato non è valido.

  • Il valore cbMax del buffer dei parametri pvResult specificato è minore delle dimensioni necessarie per l'output di questo parametro InfoLevel.

  • Per InfoLevel = JET_ErrorInfoSpecificErr, il valore JET_ERR passato è sconosciuto al motore.

JET_errDisabledFunctionality

Se questo SKU di Windows non supporta questa funzione, verrà restituito questo errore.

In caso di esito positivo, il buffer di output appropriato per il contesto/valore di errore richiesto verrà impostato sulle informazioni di errore estese richieste.

In caso di errore, lo stato dei buffer di output non sarà definito.

Commenti

La funzione JET_ERRINFOBASIC_W e JET_ERRCAT gruppo di costanti contengono documentazione sulle informazioni estese sugli errori restituite per InfoLevel = JET_ErrorInfoSpecificErr.

Requisiti

Requisito Valore

Client

Richiede Windows 8.

Server

Richiede Windows 8 Server.

Intestazione

Dichiarato in Esent.h.

Libreria

Usare ESENT.lib.

DLL

Richiede ESENT.dll.

Unicode

Nota: viene implementato solo JetGetErrorInfoW (Unicode). Questa API non ha una versione A (ANSI).