Marshal.GetObjectsForNativeVariants Método

Definição

Sobrecargas

GetObjectsForNativeVariants(IntPtr, Int32)

Converte uma matriz de VARIANTEs do COM em uma matriz de objetos.Converts an array of COM VARIANTs to an array of objects.

GetObjectsForNativeVariants<T>(IntPtr, Int32)

[Suporte somente no .NET Framework 4.5.1 e versões posteriores][Supported in the .NET Framework 4.5.1 and later versions]

Converte uma matriz de VARIANTEs do COM em uma matriz de um tipo especificado.Converts an array of COM VARIANTs to an array of a specified type.

GetObjectsForNativeVariants(IntPtr, Int32)

Aviso

Esta API agora é obsoleta.

Converte uma matriz de VARIANTEs do COM em uma matriz de objetos.Converts an array of COM VARIANTs to an array of objects.

public:
 static cli::array <System::Object ^> ^ GetObjectsForNativeVariants(IntPtr aSrcNativeVariant, int cVars);
[System.Obsolete("GetObjectsForNativeVariants(IntPtr, Int32) may be unavailable in future releases.")]
[System.Security.SecurityCritical]
public static object[] GetObjectsForNativeVariants (IntPtr aSrcNativeVariant, int cVars);
static member GetObjectsForNativeVariants : nativeint * int -> obj[]
Public Shared Function GetObjectsForNativeVariants (aSrcNativeVariant As IntPtr, cVars As Integer) As Object()

Parâmetros

aSrcNativeVariant
IntPtr

Um ponteiro para o primeiro elemento de uma matriz de VARIANTES do COM.A pointer to the first element of an array of COM VARIANTs.

cVars
Int32

A contagem de VARIANTES COM em aSrcNativeVariant.The count of COM VARIANTs in aSrcNativeVariant.

Retornos

Object[]

Uma matriz de objetos que corresponde a aSrcNativeVariant.An object array that corresponds to aSrcNativeVariant.

Atributos

Exceções

cVars é um número negativo.cVars is a negative number.

Comentários

GetObjectsForNativeVariants retorna uma matriz de objetos gerenciados que corresponde a um ponteiro bruto para uma matriz C-Style de tipos VARIAntes não gerenciados.GetObjectsForNativeVariants returns an array of managed objects that corresponds to a raw pointer to a C-style array of unmanaged VARIANT types. O interopmarshaler executa a transformação idêntica ao expor um tipo de variante para código gerenciado.The interopmarshaler performs the identical transformation when exposing a VARIANT type to managed code. O método retorna uma matriz vazia quando o parâmetro cVars é 0.The method returns an empty array when the cVars parameter is 0.

A matriz de objetos (o valor de retorno) Obtém o lixo coletado como de costume.The object array (the return value) gets garbage collected as usual. A matriz de entrada não gerenciada ou as VARIAntes individuais na matriz de entrada não são liberadas.The unmanaged input array or individual VARIANTs in the input array are not freed. Portanto, é sua responsabilidade liberá-los conforme apropriado.Therefore it is your responsibility to free them as appropriate.

Segurança

SecurityCriticalAttribute
requer confiança total para o chamador imediato.requires full trust for the immediate caller. Este membro não pode ser usado pelo código transparente ou parcialmente confiável.This member cannot be used by partially trusted or transparent code.

GetObjectsForNativeVariants<T>(IntPtr, Int32)

Aviso

Esta API agora é obsoleta.

[Suporte somente no .NET Framework 4.5.1 e versões posteriores][Supported in the .NET Framework 4.5.1 and later versions]

Converte uma matriz de VARIANTEs do COM em uma matriz de um tipo especificado.Converts an array of COM VARIANTs to an array of a specified type.

public:
generic <typename T>
 static cli::array <T> ^ GetObjectsForNativeVariants(IntPtr aSrcNativeVariant, int cVars);
[System.Obsolete("GetObjectsForNativeVariants<T>(IntPtr, Int32) may be unavailable in future releases.")]
[System.Security.SecurityCritical]
public static T[] GetObjectsForNativeVariants<T> (IntPtr aSrcNativeVariant, int cVars);
static member GetObjectsForNativeVariants : nativeint * int -> 'T[]
Public Shared Function GetObjectsForNativeVariants(Of T) (aSrcNativeVariant As IntPtr, cVars As Integer) As T()

Parâmetros de tipo

T

O tipo da matriz a ser retornada.The type of the array to return.

Parâmetros

aSrcNativeVariant
IntPtr

Um ponteiro para o primeiro elemento de uma matriz de VARIANTES do COM.A pointer to the first element of an array of COM VARIANTs.

cVars
Int32

A contagem de VARIANTES COM em aSrcNativeVariant.The count of COM VARIANTs in aSrcNativeVariant.

Retornos

T[]

Uma matriz de objetos T que corresponde a aSrcNativeVariant.An array of T objects that corresponds to aSrcNativeVariant.

Atributos

Exceções

cVars é um número negativo.cVars is a negative number.

Comentários

GetObjectsForNativeVariants<T>(IntPtr, Int32) retorna uma matriz de T que corresponde a um ponteiro bruto para uma matriz C-Style de tipos VARIAntes não gerenciados.GetObjectsForNativeVariants<T>(IntPtr, Int32) returns an array of T that corresponds to a raw pointer to a C-style array of unmanaged VARIANT types. O interopmarshaler executa a transformação idêntica ao expor um tipo de variante para código gerenciado.The interopmarshaler performs the identical transformation when exposing a VARIANT type to managed code. O método retorna uma matriz vazia quando o parâmetro cVars é 0.The method returns an empty array when the cVars parameter is 0.

A matriz retornada é lixo coletada como de costume.The returned array is garbage-collected as usual. A matriz de entrada não gerenciada ou as VARIAntes individuais na matriz de entrada não são liberadas.The unmanaged input array or individual VARIANTs in the input array are not freed. Portanto, é sua responsabilidade liberá-los conforme apropriado.Therefore, it is your responsibility to free them as appropriate.

Segurança

SecurityCriticalAttribute
requer confiança total para o chamador imediato.requires full trust for the immediate caller. Este membro não pode ser usado pelo código transparente ou parcialmente confiável.This member cannot be used by partially trusted or transparent code.

Aplica-se a