GetObjectText işlevi

Yönetilen Nesne Biçimi (MOF) söz diziminde nesnenin metinsel işlemesini döndürür.

Not

Bu API yalnızca dahili kullanım içindir. Geliştirici kodundan kullanıma yönelik değildir.

Sözdizimi

HRESULT GetObjectText (
   [in] int                vFunc,
   [in] IWbemClassObject*   ptr,
   [in] LONG                lFlags,
   [out] BSTR*              pstrObjectText
);

Parametreler

vFunc
[in] Bu parametre kullanılmadı.

ptr
[in] IWbemClassObject örneğinin işaretçisi .

lFlags
[in] Normalde 0. (veya 0x1) belirtilirse WBEM_FLAG_NO_FLAVORS , niteleyiciler yayma veya aroma bilgisi olmadan eklenir.

pstrObjectText [out] Üzerinde girdisine yönelik bir null işaretçi. Sonuç olarak, nesnenin MOF söz dizimi işlemesini içeren yeni ayrılmıştır BSTR .

Döndürülen değer

Bu işlev tarafından döndürülen aşağıdaki değerler WbemCli.h üst bilgi dosyasında tanımlanır veya bunları kodunuzda sabit olarak tanımlayabilirsiniz:

Sabit	Değer	Açıklama
WBEM_E_FAILED	0x80041001	Genel bir hata oluştu.
WBEM_E_INVALID_PARAMETER	0x80041008	Parametre geçerli değil.
WBEM_E_OUT_OF_MEMORY	0x80041006	İşlemi tamamlamak için yeterli bellek yok.
WBEM_S_NO_ERROR	0	İşlev çağrısı başarılı oldu.

Açıklamalar

Bu işlev , IWbemClassObject::GetObjectText yöntemine yapılan çağrıyı sarmalar.

Döndürülen MOF metni nesneyle ilgili tüm bilgileri değil, yalnızca MOF derleyicisinin özgün nesneyi yeniden oluşturabilmesi için yeterli bilgiyi içerir. Örneğin, yayılan niteleyiciler veya üst sınıf özellikleri dahil edilmez.

Aşağıdaki algoritma, bir yöntemin parametrelerinin metnini yeniden oluşturmak için kullanılır:

1. Parametreler, tanımlayıcı değerlerinin sırasına göre yeniden sorguya alınır.
2. ve [out] olarak [in] belirtilen parametreler tek bir parametrede birleştirilir.

pstrObjectText işlevi çağrıldığında bir null işaretçi olmalıdır; işaretçi serbest bırakılmayacağından, yöntem çağrısından önce geçerli olan bir dizeyi işaret etmemelidir.

Gereksinimler

Platform: Bkz. Sistem Gereksinimleri.

Üstbilgi: WMINet_Utils.idl

.NET Framework Sürümleri: 4.7.2 sürümünden itibaren kullanılabilir

Ayrıca bkz.

• WMI ve Performans Sayaçları (Yönetilmeyen API Başvurusu)