WeakReference Sınıfı

WRL altyapısını destekler ve doğrudan kodunuzdan kullanılmak üzere tasarlanmamıştır.

Sözdizimi

class WeakReference;

Açıklamalar

Windows Çalışma Zamanı veya klasik COM ile kullanılabilecek zayıf bir başvuruyu temsil eder. Zayıf başvuru, erişilebilir veya erişilebilir olmayabilecek bir nesneyi temsil eder.

NesneWeakReference, bir nesnenin işaretçisi olan güçlü bir başvuruyu ve yöntemi tarafından Resolve() dağıtılan güçlü başvurunun kopyalarının sayısı olan güçlü başvuru sayısını korur. Güçlü başvuru sayısı sıfırdan farklı olsa da, güçlü başvuru geçerli ve nesnesi erişilebilir. Güçlü başvuru sayısı sıfır olduğunda, güçlü başvuru geçersiz olur ve nesneye erişilemez.

Nesne WeakReference genellikle varlığı dış iş parçacığı veya uygulama tarafından denetlenen bir nesneyi temsil etmek için kullanılır. Örneğin, bir WeakReference dosya nesnesine yapılan başvurudan bir nesne oluşturun. Dosya açıkken, güçlü başvuru geçerlidir. Ancak dosya kapatılırsa, güçlü başvuru geçersiz olur.

WeakReference Yöntemler iş parçacığı güvenlidir.

Üyeler

Ortak Oluşturucular

Genel Yöntemler

Devralma Hiyerarşisi

WeakReference

Gereksinimler

Üst bilgi: implements.h

Ad Alanı: Microsoft::WRL::D etails

WeakReference::~WeakReference

WRL altyapısını destekler ve doğrudan kodunuzdan kullanılmak üzere tasarlanmamıştır.

virtual ~WeakReference();

Dönüş Değeri

Açıklamalar

Sınıfın geçerli örneğini WeakReference başlatır.

WeakReference::D ecrementStrongReference

WRL altyapısını destekler ve doğrudan kodunuzdan kullanılmak üzere tasarlanmamıştır.

ULONG DecrementStrongReference();

Açıklamalar

Geçerli WeakReference nesnenin güçlü başvuru sayısını azaltma.

Güçlü başvuru sayısı sıfır olduğunda, güçlü başvuru olarak nullptrayarlanır.

Dönüş Değeri

Azalan güçlü başvuru sayısı.

WeakReference::IncrementStrongReference

WRL altyapısını destekler ve doğrudan kodunuzdan kullanılmak üzere tasarlanmamıştır.

ULONG IncrementStrongReference();

Dönüş Değeri

Artan güçlü başvuru sayısı.

Açıklamalar

Geçerli WeakReference nesnenin güçlü başvuru sayısını artırır.

WeakReference::Resolve

WRL altyapısını destekler ve doğrudan kodunuzdan kullanılmak üzere tasarlanmamıştır.

STDMETHOD(Resolve)
   (REFIID riid,
   _Deref_out_opt_ IInspectable **ppvObject
);

Parametreler

riid
Arabirim kimliği.

ppvObject
Bu işlem tamamlandığında, güçlü başvuru sayısı sıfır olmayansa geçerli güçlü başvurunun bir kopyası.

Dönüş Değeri

• Bu işlemin başarılı olup olmadığını ve güçlü başvuru sayısının sıfır olup olmadığını S_OK. ppvObject parametresi olarak nullptrayarlanır.

• Bu işlemin başarılı olup olmadığını ve güçlü başvuru sayısının sıfır olmayan olup olmadığını S_OK. ppvObject parametresi, güçlü başvuruya ayarlanır.

• Aksi takdirde, bu işlemin başarısız olmasının nedenini gösteren bir HRESULT.

Açıklamalar

Güçlü başvuru sayısı sıfırdan farklıysa, belirtilen işaretçiyi geçerli güçlü başvuru değerine ayarlar.

WeakReference::SetUnknown

WRL altyapısını destekler ve doğrudan kodunuzdan kullanılmak üzere tasarlanmamıştır.

void SetUnknown(
   _In_ IUnknown* unk
);

Parametreler

unk
Bir nesnenin IUnknown arabirimine yönelik bir işaretçi.

Açıklamalar

Geçerli WeakReference nesnenin güçlü başvuruyu belirtilen arabirim işaretçisine ayarlar.

WeakReference::WeakReference

WRL altyapısını destekler ve doğrudan kodunuzdan kullanılmak üzere tasarlanmamıştır.

WeakReference();

Açıklamalar

WeakReference sınıfının yeni bir örneğini başlatır.

Nesnenin WeakReference güçlü başvuru işaretçisi olarak nullptrbaşlatılır ve güçlü başvuru sayısı 1 olarak başlatılır.