Funzione JetSetSessionParameter

Si applica a: Windows | Windows Server

La funzione JetSetSessionParameter configura il motore di database.

JET_ERR JET_API JetSetSessionParameter (
  __in_opt      JET_SESID sesid,
  __in          unsigned long sesparamid,
  __in_read_bytes_opt_(cbParam)  void* pvParam,
  __in          unsigned long cbParam
);

Parametri

sesid

Specifica la sessione da usare per questa chiamata.

Se specificato, l'istanza specificata viene ignorata e verrà usata l'istanza associata alla sessione.

sesparamid

ID del parametro di sessione da impostare.

pvParam

Dati da impostare in questo parametro di sessione.

cbParam

Dimensioni dei dati forniti.

Valore restituito

Questa funzione restituisce il tipo di dati JET_ERR con uno dei codici restituiti elencati nella tabella seguente. Per altre informazioni sugli eventuali errori di Estendibilità del motore di archiviazione (ESE), vedere Errori del motore di archiviazione estendibili e parametri di gestione degli errori.

Codice restituito	Descrizione
JET_errSuccess	Operazione riuscita.
JET_errAlreadyInitialized	L'istanza è stata inizializzata usando una chiamata alla funzione JetInit e questa operazione non può essere eseguita di conseguenza. Ciò può verificarsi quando viene eseguito un tentativo di configurare un parametro di sistema dopo una modifica nel valore del parametro non può più influire sullo stato del motore di database.
JET_errClientRequestToStopJetService	Non è possibile completare l'operazione perché tutte le attività nell'istanza associata alla sessione hanno interrotto come risultato di una chiamata alla funzione JetStopService .
JET_errIndexTuplesInvalidLimits	I parametri di indice tuple specificati non sono validi. Questo errore viene restituito solo quando il parametro JET_paramIndexTuplesLengthMin, JET_paramIndexTuplesLengthMax o JET_paramIndexTuplesToIndexMax è impostato su un valore non valido. Per informazioni su questi parametri, vedere Parametri di indice.
JET_errInitInProgress	Non è possibile completare l'operazione perché l'istanza associata alla sessione viene inizializzata.
JET_errInstanceUnavailable	Non è possibile completare l'operazione perché l'istanza associata alla sessione ha rilevato un errore irreversibile che richiede che l'accesso a tutti i dati venga revocato per proteggere l'integrità dei dati.
JET_errInvalidParameter	Uno dei parametri forniti contiene un valore imprevisto o contiene un valore che non ha senso quando si combina con il valore di un altro parametro. Ciò può verificarsi quando si verifica quanto segue: L'ID del parametro di sistema specificato non è valido o non supportato. È stato effettuato un tentativo di impostare un parametro di sistema con valori stringa con una stringa la cui lunghezza era esterna all'intervallo legale per il parametro. È stato effettuato un tentativo di impostare un parametro di sistema con valori stringa con un percorso file in cui la lunghezza della rappresentazione assoluta del percorso era esterna all'intervallo legale per tale parametro. È stato effettuato un tentativo di impostare un parametro di sistema con valori interi con un valore intero che era all'esterno dell'intervallo legale per il parametro. È stato effettuato un tentativo di impostare JET_paramUnicodeIndexDefault con un puntatore null JET_UNICODEINDEX , un LCID non valido o un set non supportato di flag LCMapString . Impossibile impostare il parametro di sistema specificato perché è di sola lettura. È stato eseguito un tentativo di impostare un parametro di sistema dopo la chiamata della funzione JetInit , il motore di database è in modalità istanza singola e una sessione non è stata specificata. Il parametro di sistema specificato è globale solo e viene eseguito un tentativo di impostare un valore specifico dell'istanza per tale parametro di sistema. Il parametro di sistema specificato è solo per istanza e viene eseguito un tentativo di impostare il valore globale per tale parametro di sistema.
JET_errInvalidPath	Il percorso del file system specificato non è valido. Questo errore può essere restituito da JetSetSessionParameter solo quando si impostano i parametri di sistema che rappresentano i percorsi del file system. Ad esempio, il parametro JET_paramSystemPath può restituire questo errore. Per informazioni su questo parametro, vedere Parametri del log delle transazioni.
JET_errNotInitialized	Non è possibile completare l'operazione perché l'istanza associata alla sessione non è ancora stata inizializzata.
JET_errRestoreInProgress	Non è possibile completare l'operazione perché un'operazione di ripristino è in corso nell'istanza associata alla sessione.
JET_errTermInProgress	Non è possibile completare l'operazione perché l'istanza associata alla sessione viene arrestata.
JET_errInvalidSesid	L'handle di sessione non è valido o fa riferimento a una sessione chiusa. Questo errore non viene restituito in tutte le circostanze. Gli handle vengono convalidati solo su base ottimale.
JET_errInvalidInstance	L'handle dell'istanza non è valido o fa riferimento a un'istanza che è stata arrestata. Questo errore non viene restituito in tutte le circostanze. Gli handle vengono convalidati solo su base ottimale.

In caso di esito positivo, il parametro di sistema verrà impostato sul valore specificato.

In caso di errore, il valore del parametro di sistema rimarrà invariato.

Requisiti

Requisito	Valore
Client	Richiede Windows 8.
Server	Richiede Windows Server 2012.
Intestazione	Dichiarato in Esent.h.
Libreria	Usare ESENT.lib.
DLL	Richiede ESENT.dll.

Vedi anche

JET_API_PTR
JET_ERR
JET_INSTANCE
JET_SESID
JetCreateInstance
JetGetSystemParameter
JetInit
Parametri di sistema