Marshal.AddRef(IntPtr) Yöntem

Başvuru

Tanım

Ad Alanı:: System.Runtime.InteropServices

Bütünleştirilmiş Kod:: System.Runtime.InteropServices.dll

Bütünleştirilmiş Kod:: mscorlib.dll

Bütünleştirilmiş Kod:: netstandard.dll

Önemli

Bazı bilgiler ürünün ön sürümüyle ilgilidir ve sürüm öncesinde önemli değişiklikler yapılmış olabilir. Burada verilen bilgilerle ilgili olarak Microsoft açık veya zımni hiçbir garanti vermez.

Belirtilen arabirimdeki başvuru sayısını artırır.

public:
 static int AddRef(IntPtr pUnk);

[System.Security.SecurityCritical]
public static int AddRef (IntPtr pUnk);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static int AddRef (IntPtr pUnk);

public static int AddRef (IntPtr pUnk);

[<System.Security.SecurityCritical>]
static member AddRef : nativeint -> int

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member AddRef : nativeint -> int

static member AddRef : nativeint -> int

Public Shared Function AddRef (pUnk As IntPtr) As Integer

Parametreler

pUnk: IntPtr
nativeint

Artıracak arabirim başvuru sayısı.

Döndürülenler

Int32

Parametredeki başvuru sayısının pUnk yeni değeri.

Öznitelikler: SecurityCriticalAttribute SupportedOSPlatformAttribute

Açıklamalar

Ortak dil çalışma zamanı, bir COM nesnesinin başvuru sayısını sizin için yönetir ve bu yöntemin doğrudan kullanılmasını gereksiz hale getirir. Özel bir sıralayıcıyı test etme gibi nadir durumlarda, bir nesnenin ömrünü el ile işlemeyi gerekli bulabilirsiniz. çağrısı AddRefyaptıktan sonra, gibi Marshal.Releasebir yöntem kullanarak başvuru sayısını azaltmanız gerekir. bazen kararsız olabileceğinden değerinin AddRefdönüş değerine güvenmeyin.

Bir IUnknown arabirim işaretçisini temsil eden bir IntPtr değer elde etmek için , Marshal.GetIUnknownForObjectveya Marshal.GetIDispatchForObject çağırabilirsinizMarshal.GetComInterfaceForObject. Yönetilen nesnenin AddRef COM çağrılabilen sarmalayıcısı tarafından temsil edilen COM arabirimlerini almak için bu yöntemleri ve yöntemini yönetilen nesneler üzerinde de kullanabilirsiniz. Bu sarmalayıcı türünün ayrıntılarını tanımıyorsanız bkz. COM Çağrılabilen Sarmalayıcı.

Şunlara uygulanır