JetGetIndexInfo İşlevi

Şunlar için geçerlidir: Windows | Windows Server

JetGetIndexInfo İşlevi

JetGetIndexInfo işlevi bir dizin hakkındaki bilgileri alır.

    JET_ERR JET_API JetGetIndexInfo(
      __in          JET_SESID sesid,
      __in          JET_DBID dbid,
      __in          const tchar* szTableName,
      __in          const tchar* szIndexName,
      __out         void* pvResult,
      __in          unsigned long cbResult,
      __in          unsigned long InfoLevel
    );

Parametreler

sesid

API çağrısı için kullanılacak veritabanı oturumu bağlamı.

dbid

API çağrısı için kullanılacak veritabanı tanımlayıcısı.

szTableName

Alınacak bilgilerle birlikte dizini içeren tablonun adı.

szIndexName

Alınacak bilgileri içeren dizinin adı.

pvResult

İstenen bilgileri alacak bir arabelleğe işaretçi. Arabellek, gerekli türü tutacak şekilde hizalanmalıdır. Arabelleğin türü InfoLevel parametresine bağlıdır.

cbResult

pvResult olarak geçirilen arabelleğin bayt cinsinden boyutu.

InfoLevel

pvResult içinde depolanacak bilgiler. Bu parametre için aşağıdaki seçenekler kullanılabilir.

Değer	Meaning
JET_IdxInfo	pvResult , JET_INDEXLIST bir yapı olarak yorumlanır. Başarılı olduğunda , JET_INDEXLIST yapısı dizin hakkında bilgi alır. Hata durumunda pvBuffer içeriği tanımlanmamıştır.
JET_IdxInfoCount	pvResult , ULONG olarak yorumlanır. Başarılı olduğunda, ULONG belirtilen tablodaki dizinlerin sayısını tutar. szIndexName yoksayılır. Hata durumunda pvBuffer içeriği tanımlanmamıştır.
JET_IdxInfoIndexId	pvResult , JET_INDEXID olarak yorumlanır. Başarılı olduğunda , JET_INDEXID yapısı dizin hakkında bilgi alır. Hata durumunda pvBuffer içeriği tanımlanmamıştır.
JET_IdxInfoLangid	JET_IdxInfoLangid kullanım dışı bırakıldı. Bunun yerine JET_IdxInfoLCID ve LANGIDFROMLCID makrosunu kullanın.
JET_IdxInfoLCID	pvResult , LCID olarak yorumlanır. Başarılı olduğunda, LCID dizinin Yerel Ayar Tanımlayıcısını tutar. Hata durumunda pvBuffer içeriği tanımlanmamıştır. Windows XP: JET_IdxInfoLCID Windows XP tanıtılır.
JET_IdxInfoList	pvResult , JET_INDEXLIST bir yapı olarak yorumlanır. Başarılı olduğunda , JET_INDEXLIST yapısı dizin hakkında bilgi alır. Hata durumunda pvBuffer içeriği tanımlanmamıştır.
JET_IdxInfoOLC	JET_IdxInfoOLC artık kullanılmıyor.
JET_IdxInfoResetOLC	JET_IdxInfoResetOLC artık kullanılmıyor.
JET_IdxInfoSpaceAlloc	pvResult , ULONG olarak yorumlanır. Başarılı olduğunda ULONG, dizinin hedef yoğunluğuna (ulDensity) sahiptir. ulDensity'nin açıklaması için bkz. JET_INDEXCREATE. Hata durumunda pvBuffer içeriği tanımlanmamıştır.
JET_IdxInfoSysTabCursor	JET_IdxInfoSysTabCursor artık kullanılmıyor.
JET_IdxInfoVarSegMac	pvResult , USHORT olarak yorumlanır. Başarılı olduğunda USHORT, dizin oluşturulurken kullanılan cbVarSegMac değerini tutar. cbVarSegMac açıklaması için bkz. JET_INDEXCREATE. Hata durumunda pvBuffer içeriği tanımlanmamıştır.
JET_IdxInfoKeyMost	pvResult , USHORT olarak yorumlanır. Başarılı olduğunda USHORT, dizin oluşturulurken kullanılan cbKeyMost değerini tutar. cbKeyMost açıklaması için bkz. JET_INDEXCREATE. Hata durumunda pvBuffer içeriği tanımlanmamıştır. Windows Vista: JET_IdxInfoKeyMost Windows Vista tanıtılır.
JET_IdxInfoCreateIndex	pvResult , JET_INDEXCREATE bir yapı olarak yorumlanır. Hata durumunda pvBuffer içeriği tanımlanmamıştır. Windows 7: JET_IdxInfoCreateIndex Windows 7 tanıtılır.
JET_IdxInfoCreateIndex2	pvResult , JET_INDEXCREATE2 bir yapı olarak yorumlanır. Hata durumunda pvBuffer içeriği tanımlanmamıştır. Windows 7: JET_IdxInfoCreateIndex2 Windows 7 tanıtılır.
JET_IdxInfoSpaceOwned	pvResult olarak ULONGyorumlanır. Başarılı olduğunda ULONG , dizinin sahip olduğu sayfa sayısını tutar. Daha fazla bilgi için bkz . Açıklamalar . Windows 11:JET_IdxInfoSpaceOwned Windows 11 tanıtılır.
JET_IdxInfoSpaceAvail	pvResult olarak ULONGyorumlanır. Başarılı olduğunda ULONG , dizinde kullanılabilir sayfa sayısını tutar. Daha fazla bilgi için bkz . Açıklamalar . Windows 11:JET_IdxInfoSpaceAvail Windows 11 tanıtılır.

Dönüş Değeri

Bu işlev, aşağıdaki dönüş kodlarından biriyle JET_ERR veri türünü döndürür. Olası ESE hataları hakkında daha fazla bilgi için bkz. Genişletilebilir Depolama Altyapısı Hataları ve Hata İşleme Parametreleri.

İade kodu	Açıklama
JET_errSuccess	İşlem başarıyla tamamlandı.
JET_errIndexNotFound	Belirtilen dizin belirtilen tabloda bulunamıyor.
JET_wrnBufferTruncated	pvResult olarak geçirilen arabellek çok küçük. Arabelleğin içeriği tanımsız.

Açıklamalar

JetGetIndexInfo ve JetGetTableIndexInfo , dizinle ilgili aynı bilgileri alır. Fark, tablonun nasıl belirtildiğidir. JetGetIndexInfo bir veritabanı (dbid) ve bir tablonun adını (szTableName) beklerken , JetGetTableIndexInfo bir tablo tanımlayıcısı (tableid) bekler.

Dizin tarafından tüketilen alan $Used + Avail = Owned$ tarafından tanımlanır. Bu nedenle, kullanımdaki sayfa sayısını almak için $Owned - Avail = Used$ ( JET_IdxInfoSpaceOwned ve JET_IdxInfoSpaceAvail ile alınabilir) formülünü kullanın.

Requirements

Gereksinim	Değer
Müşteri	Windows Vista, Windows XP veya Windows 2000 Professional gerektirir.
Sunucu	Windows Server 2008, Windows Server 2003 veya Windows 2000 Server gerektirir.
Üstbilgi	Esent.h.'de bildirildi.
Kitaplık	ESENT.lib kullanın.
DLL	ESENT.dllgerektirir.
Unicode	JetGetIndexInfoW (Unicode) ve JetGetIndexInfoA (ANSI) olarak uygulanır.

Ayrıca Bkz.

JetGetTableIndexInfoJET_TABLEID JET_INDEXIDJET_INDEXCREATE2 JET_INDEXLIST JET_SESIDJET_INDEXCREATEJET_INDEXCREATE JET_GRBIT JET_ERR JET_COLUMNID