Funzione JetGetErrorInfoW

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).