Put işlevi

Adlandırılmış özelliği yeni bir değere ayarlar.

Not

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

Sözdizimi

HRESULT Put (
   [in] int               vFunc,
   [in] IWbemClassObject* ptr,
   [in] LPCWSTR           wszName,
   [in] LONG              lFlags,
   [in] VARIANT*          pVal,
   [in] CIMTYPE           vtType
);

Parametreler

vFunc
[in] Bu parametre kullanılmadı.

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

wszName
[in] Özelliğin adı. Bu parametre olamaz null.

lFlags
[in] Saklı -dır. Bu parametre 0 olmalıdır.

pVal
[in] Yeni özellik değerine dönüşen geçerli VARIANT bir işaretçi. türündeyse nullpVal veya işaret ederseVT_NULLVARIANT, özelliği olarak nullayarlanır.

vtType
[in] tarafından pValişaret edilen türüVARIANT. Daha fazla bilgi için Açıklamalar bölümüne bakın.

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	Bir veya daha fazla parametre geçerli değil.
WBEM_E_INVALID_PROPERTY_TYPE	0x8004102a	Özellik türü tanınmıyor. Sınıf zaten varsa, sınıf örnekleri oluşturulurken bu değer döndürülür.
WBEM_E_OUT_OF_MEMORY	0x80041006	İşlemi tamamlamak için yeterli bellek yok.
WBEM_E_TYPE_MISMATCH	0x80041005	Örnekler için: Özelliği için yanlış türe VARIANT işaret ettiğini pVal gösterir. Sınıf tanımları için: Özellik üst sınıfta zaten var ve yeni COM türü eski COM türünden farklı.
WBEM_S_NO_ERROR	0	İşlev çağrısı başarılı oldu.

Açıklamalar

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

Bu işlev her zaman geçerli özellik değerinin üzerine yenisini yazar. IWbemClassObject bir sınıf tanımına işaret ederse, Put özellik değerini oluşturur veya güncelleştirir. IWbemClassObject bir CIM örneğine işaret ettiğinde, Put yalnızca özellik değerini güncelleştirir; Put özellik değeri oluşturamaz.

__CLASS Sistem özelliği yalnızca boş bırakılmayabilecek sınıf oluşturma sırasında yazılabilir. Diğer tüm sistem özellikleri salt okunur durumdadır.

Kullanıcı, alt çizgiyle ("_") başlayan veya biten adlara sahip özellikler oluşturamaz. Bu, sistem sınıfları ve özellikleri için ayrılmıştır.

İşlev tarafından Put ayarlanan özellik üst sınıfta varsa, özellik türü üst sınıf türüyle eşleşmediği sürece özelliğin varsayılan değeri değiştirilir. Özellik yoksa ve tür uyuşmazlığı değilse, özellik oluşturulur.

Parametresini vtType yalnızca CIM sınıf tanımında yeni özellikler oluştururken kullanın ve pValnull türünde VT_NULLveya türünde bir VARIANT öğesine işaret edin. Bu durumda parametresi özelliğin vType CIM türünü belirtir. Diğer her durumda vtType 0 olmalıdır. vtType özelliğin türü sabit olduğundan ve değiştirilemediğinden, temel alınan nesne bir örnekse (olsa Valnullbile) 0 olmalıdır.

Örnek

Bir örnek için bkz. IWbemClassObject::P ut yöntemi.

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)