GetPropertyHandle işlevi

Bir özelliği tanımlayan benzersiz bir tanıtıcı 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 GetPropertyHandle (
   [in] int                  vFunc,
   [in] IWbemObjectAccess*   ptr,
   [in] LPCWSTR              wszPropertyName,
   [out] CIMTYPE*            pType,
   [out] long*               pHandle
);

Parametreler

vFunc
[in] Bu parametre kullanılmadı.

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

wszPropertyName
[in] Özellik adını içeren UTF16 ile kodlanmış karakterlerin null olarak sonlandırılan dizesi.

pType
[out] Özelliğin CIM türünü temsil eden bir CIMTYPE numaralandırma üyesinin işaretçisi.

pHandle
[out] Özellik tutamacını içeren bir tamsayı 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_NOT_FOUND	0x80041002	Belirtilen özellik adı bulunamadı.
WBEM_E_INVALID_PARAMETER	0x80041008	Parametre geçerli değil.
WBEM_E_NOT_SUPPORTED	0x8004100c	İstenen özellik veya CIM_ARRAYtüründedirCIM_OBJECT.
WBEM_S_NO_ERROR	0	İşlev çağrısı başarılı oldu.

Açıklamalar

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

Özellik değerlerini okumak veya yazmak için IWbemObjectAccess yöntemlerini kullanırken özellikleri tanımlamak için bu tutamacı kullanabilirsiniz.

ve dışındaki CIM_OBJECTCIM_ARRAYtüm veri türlerinin özellikleri için tanıtıcılar alınabilir. Döndürülen tanıtıcılar bir sınıfın tüm örnekleri arasında çalışır.

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)