Auf Englisch lesen

Freigeben über


Marshal.GetObjectsForNativeVariants Methode

Definition

Überlädt

GetObjectsForNativeVariants(IntPtr, Int32)
Veraltet.

Konvertiert ein Array mit COM-VARIANTs in ein Array von Objekten.

GetObjectsForNativeVariants<T>(IntPtr, Int32)
Veraltet.

Konvertiert ein Array mit COM-VARIANT in ein Array eines angegebenen Typs.

GetObjectsForNativeVariants(IntPtr, Int32)

Quelle:
Marshal.NoCom.cs
Quelle:
Marshal.NoCom.cs
Quelle:
Marshal.NoCom.cs

Achtung

GetObjectsForNativeVariants(IntPtr, Int32) may be unavailable in future releases.

Konvertiert ein Array mit COM-VARIANTs in ein Array von Objekten.

C#
[System.Obsolete("GetObjectsForNativeVariants(IntPtr, Int32) may be unavailable in future releases.")]
[System.Security.SecurityCritical]
public static object[] GetObjectsForNativeVariants(IntPtr aSrcNativeVariant, int cVars);
C#
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static object?[] GetObjectsForNativeVariants(IntPtr aSrcNativeVariant, int cVars);
C#
[System.Obsolete("GetObjectsForNativeVariants(IntPtr, Int32) may be unavailable in future releases.")]
public static object[] GetObjectsForNativeVariants(IntPtr aSrcNativeVariant, int cVars);
C#
public static object?[] GetObjectsForNativeVariants(IntPtr aSrcNativeVariant, int cVars);
C#
public static object[] GetObjectsForNativeVariants(IntPtr aSrcNativeVariant, int cVars);
C#
[System.Security.SecurityCritical]
public static object[] GetObjectsForNativeVariants(IntPtr aSrcNativeVariant, int cVars);

Parameter

aSrcNativeVariant
IntPtr

Ein Zeiger auf das erste Element eines Arrays von COM-VARIANTs.

cVars
Int32

Die Zählung der COM-VARIANT in aSrcNativeVariant.

Gibt zurück

Object[]

Ein Objektarray, das diesem aSrcNativeVariant entspricht.

Attribute

Ausnahmen

cVars ist eine negative Zahl.

Hinweise

GetObjectsForNativeVariants gibt ein Array verwalteter Objekte zurück, das einem unformatierten Zeiger auf ein Array im C-Stil von nicht verwalteten VARIANT-Typen entspricht. Der Interopmarshaler führt die identische Transformation durch, wenn ein VARIANT-Typ verwaltetem Code verfügbar macht. Die Methode gibt ein leeres Array zurück, wenn der cVars Parameter 0 ist.

Das Objektarray (der Rückgabewert) erhält wie gewohnt Müll gesammelt. Das nicht verwaltete Eingabearray oder einzelne VARIANTs im Eingabearray werden nicht freigegeben. Daher liegt es in Ihrer Verantwortung, sie nach Bedarf freizugeben.

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen (Veraltet)
.NET Core 3.0, Core 3.1, 5, 6, 7, 8, 9 (Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2)
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 2.0 (1.2, 1.3, 1.4, 1.5, 1.6, 2.1)
UWP (10.0)

GetObjectsForNativeVariants<T>(IntPtr, Int32)

Quelle:
Marshal.NoCom.cs
Quelle:
Marshal.NoCom.cs
Quelle:
Marshal.NoCom.cs

Achtung

GetObjectsForNativeVariants<T>(IntPtr, Int32) may be unavailable in future releases.

Konvertiert ein Array mit COM-VARIANT in ein Array eines angegebenen Typs.

C#
[System.Obsolete("GetObjectsForNativeVariants<T>(IntPtr, Int32) may be unavailable in future releases.")]
[System.Security.SecurityCritical]
public static T[] GetObjectsForNativeVariants<T>(IntPtr aSrcNativeVariant, int cVars);
C#
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static T[] GetObjectsForNativeVariants<T>(IntPtr aSrcNativeVariant, int cVars);
C#
[System.Obsolete("GetObjectsForNativeVariants<T>(IntPtr, Int32) may be unavailable in future releases.")]
public static T[] GetObjectsForNativeVariants<T>(IntPtr aSrcNativeVariant, int cVars);
C#
public static T[] GetObjectsForNativeVariants<T>(IntPtr aSrcNativeVariant, int cVars);
C#
[System.Security.SecurityCritical]
public static T[] GetObjectsForNativeVariants<T>(IntPtr aSrcNativeVariant, int cVars);

Typparameter

T

Der Typ des zurückzugebenden Arrays.

Parameter

aSrcNativeVariant
IntPtr

Ein Zeiger auf das erste Element eines Arrays von COM-VARIANTs.

cVars
Int32

Die Zählung der COM-VARIANT in aSrcNativeVariant.

Gibt zurück

T[]

Ein Array von T-Objekten, das aSrcNativeVariant entspricht.

Attribute

Ausnahmen

cVars ist eine negative Zahl.

Hinweise

GetObjectsForNativeVariants<T>(IntPtr, Int32) gibt ein Array von T zurück, das einem unformatierten Zeiger auf ein Array im C-Stil von nicht verwalteten VARIANT-Typen entspricht. Der Interopmarshaler führt die identische Transformation durch, wenn ein VARIANT-Typ verwaltetem Code verfügbar macht. Die Methode gibt ein leeres Array zurück, wenn der cVars Parameter 0 ist.

Das zurückgegebene Array wird wie gewohnt mit Müll gesammelt. Das nicht verwaltete Eingabearray oder einzelne VARIANTs im Eingabearray werden nicht freigegeben. Daher liegt es in Ihrer Verantwortung, sie nach Bedarf freizugeben.

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen (Veraltet)
.NET Core 3.0, Core 3.1, 5, 6, 7, 8, 9 (Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2)
.NET Framework 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0 (1.2, 1.3, 1.4, 1.5, 1.6, 2.1)
UWP (10.0)