JetGetObjectInfo İşlevi

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

JetGetObjectInfo İşlevi

JetGetObjectInfo işlevi, veritabanı nesneleri hakkında bilgi alır. Şu anda yalnızca tablolar desteklenmektedir. JetGetTableInfo , JetGetObjectInfo'dan daha fazla bilgi getirmek için kullanılabilir.

    JET_ERR JET_API JetGetObjectInfo(
      __in          JET_SESID sesid,
      __in          JET_DBID dbid,
      __in          JET_OBJTYP objtyp,
      __in_opt      const tchar* szContainerName,
      __in_opt      const tchar* szObjectName,
      __out         void* pvResult,
      __in          unsigned long cbMax,
      __in          unsigned long InfoLevel
    );

Parametreler

sesid

Kullanılacak veritabanı oturumu bağlamı.

dbid

Bilgilerin alındığı veritabanı.

objtyp

Alınacak bilgileri içeren nesneler. Şu anda, her ikisi de aynı şekilde davranan yalnızca JET_objtypNil ve JET_objtypTable desteklenir. Yalnızca tablolar alınır.

szContainerName

Bu parametre gelecekteki kullanım için ayrılmıştır ve NULL iletir. Hakkında bilgi alınacak nesne türlerinin adı.

szObjectName

Alınacak bilgileri içeren nesnenin adı. InfoLevel tüm nesnelerin listesini almak için JET_ObjInfoList veya JET_ObjInfoListNoStats seçeneklerini kullandığında, bu değer NULL veya boş bir dize olmalıdır.

Şu anda yalnızca tablo adları desteklenmektedir.

pvResult

Belirtilen bilgileri alan bir arabelleğe yönelik işaretçi.

Arabelleğin bayt cinsinden boyutu cbMax içinde geçirilir. Hata durumunda pvResult içeriği tanımlanmamıştır.

pvResult içinde depolanan bilgiler InfoLevel'e bağlıdır.

cbMax

pvResult içinde geçirilen arabelleğin bayt cinsinden boyutu.

InfoLevel

Belirtilen nesne için alınacak bilgi türünü belirtir. pvResult'un yorumlandığı şekli etkiler.

Bu parametre için aşağıdaki seçenekleri ayarlayabilirsiniz.

Değer	Anlamı
JET_ObjInfo	pvResult , JET_OBJECTINFO bir yapı olarak yorumlanır. JET_OBJECTINFO yapısı, szObjectName içinde adlandırılmış nesneyle ilgili bilgilerle doldurulur. Çağıran nesnenin kayıt ve sayfa sayısını bilmek istemiyorsa, istatistikler dahil edilmediğinden daha hızlı olabilecek JET_ObjInfoNoStats bilgi düzeyini kullanmayı göz önünde bulundurun.
JET_ObjInfoList	pvResult , JET_OBJECTLIST bir yapı olarak yorumlanır. Tüm nesneler hakkındaki bilgiler alınır. Geçici bir tablo oluşturulur ve geçici tablo arasında geçiş yapmak için gereken bilgiler JET_OBJECTLIST yapısında açıklanmıştır. Daha fazla bilgi için bkz. JET_OBJECTLIST. Çağıran nesnenin kayıt ve sayfa sayısını bilmek istemiyorsa, daha hızlı olabilecek JET_ObjInfoListNoStats kullanmayı göz önünde bulundurun.
JET_ObjInfoListACM	Kullanım dışı bırakıldı ve şu anda desteklenmiyor.
JET_ObjInfoListNoStats	pvResult , JET_OBJECTLIST bir yapı olarak yorumlanır. Tüm nesneler hakkındaki bilgiler alınır. Geçici bir tablo oluşturulur ve geçici tablo arasında geçiş yapmak için gereken bilgiler JET_OBJECTLIST yapısında açıklanmıştır. Daha fazla bilgi için bkz. JET_OBJECTLIST. JET_ObjInfoListNoStats, kayıt sayısını (columnidcRecord) ve sayfaları (columnidcPage) raporlayan sütunların güncelleştirilmemesi dışında JET_ObjInfoList aynıdır.
JET_ObjInfoMax	pvResult bir JET_OBJECTINFO olarak yorumlanır. Nesnenin en büyük boyutu sayfalardadır. Şu anda yalnızca tablolar döndürülür.
JET_ObjInfoNoStats	pvResult bir JET_OBJECTINFO olarak yorumlanır. Yalnızca szObjectName içinde verilen nesne hakkındaki bilgiler alınır. JET_OBJECTINFO yapısı, szObjectName içinde adlandırılmış nesneyle ilgili bilgilerle doldurulur. JET_ObjInfoNoStats, kayıt ve sayfa sayısını raporlayan alanların sıfır olarak ayarlanması dışında JET_ObjInfo aynıdır.
JET_ObjInfoRulesLoaded	Kullanım dışı bırakıldı ve şu anda desteklenmiyor.
JET_ObjInfoSysTabCursor	Kullanım dışı bırakıldı ve şu anda desteklenmiyor.
JET_ObjInfoSysTabReadOnly	Kullanım dışı bırakıldı ve şu anda desteklenmiyor.

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_errBufferTooSmall	cbMax içinde verilen arabellek boyutu istenen bilgileri tutmak için çok küçük.
JET_errInvalidName	szObjectName veya szContainerName içinde geçersiz bir ad verildi.
JET_errInvalidParameter	Hatalı bir parametre verildi. InfoLevel'e hatalı bir düzey geçirildi olabilir.

Açıklamalar

JetGetObjectInfo başarıyla geçici bir tablo oluşturursa (örneğin, JET_ObjInfoList veya JET_ObjInfoNoStats), geçici tabloyu JetCloseTable ile kapatmak çağıran sorumludur.

JetGetObjectInfo şu anda yalnızca tablolar hakkında bilgi almayı destekler.

Gereksinimler

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.
Başlık	Esent.h.'de bildirildi.
Kütüphane	ESENT.lib kullanın.
DLL	ESENT.dllgerektirir.
Unicode	JetGetObjectInfoW (Unicode) ve JetGetObjectInfoA (ANSI) olarak uygulanır.

Ayrıca Bkz.

JET_ERR
JET_GRBIT
JET_OBJTYP
JET_SESID
JET_TABLEID
JET_OBJECTINFO
JET_OBJECTLIST
jetclosetable
jetgettableinfo