Aracılığıyla paylaş

WritePropertyValue işlevi

  • Makale

Bir özellik tanıtıcısı tarafından tanımlanan bir özelliğe belirtilen sayıda bayt yazar.

Not

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

Sözdizimi

HRESULT WritePropertyValue (
   [in] int                  vFunc,
   [in] IWbemObjectAccess*   ptr,
   [in] long                 lHandle,
   [in] long                 lNumBytes,
   [in] byte*                aData
);

Parametreler

vFunc
[in] Bu parametre kullanılmadı.

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

lHandle
[in] Bu özelliği tanımlayan tanıtıcıyı içeren bir tamsayı. Tanıtıcı GetPropertyHandle işlevi çağrılarak alınabilir.

lNumBytes
[in] Özelliğine yazılan bayt sayısı. Daha fazla bilgi için Açıklamalar bölümüne bakın.

pHandle [out] Verileri içeren bayt dizisinin işaretçisi.

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_INVALID_PARAMETER 0x80041008 Parametre geçerli değil.
WBEM_E_TYPE_MISMATCH 0x80041005 Tür uyuşmazlığı oluştu.
WBEM_S_NO_ERROR 0 İşlev çağrısı başarılı oldu.

Açıklamalar

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

Dizeyi ve diğer veri olmayan veya olmayanDWORDQWORD tüm verileri ayarlamak için bu işlevi kullanın.

Dize olmayan özellik değerleri için, lNumBytes belirtilen özellik türünün doğru veri boyutu olmalıdır. Dize özelliği değerleri için, lNumBytes belirtilen dizenin bayt cinsinden uzunluğu olmalı ve dizenin kendisi bayt cinsinden çift uzunlukta olmalı ve ardından null sonlandırma karakteri eklenmelidir.

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.