Método Marshal.SetComObjectData (Object, Object, Object)

Artigo
04/16/2018

Dica

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Define os dados referenciados pela chave especificada no objeto COM especificado.

Namespace: System.Runtime.InteropServices
Assembly: mscorlib (em mscorlib.dll)

Sintaxe

[SecurityCriticalAttribute]
public static bool SetComObjectData(
    object obj,
    object key,
    object data
)

public:
[SecurityCriticalAttribute]
static bool SetComObjectData(
    Object^ obj,
    Object^ key,
    Object^ data
)

[<SecurityCriticalAttribute>]
static member SetComObjectData : 
        obj:Object *
        key:Object *
        data:Object -> bool

<SecurityCriticalAttribute>
Public Shared Function SetComObjectData (
    obj As Object,
    key As Object,
    data As Object
) As Boolean

Parâmetros

obj
Type: System.Object

O objeto COM no qual armazenar os dados.

key
Type: System.Object

A chave na tabela de hash interna do objeto COM na qual armazenar os dados.

data
Type: System.Object

Os dados a serem definidos.

Valor Retornado

Type: System.Boolean

true se os dados tiverem sido definidos com êxito; caso contrário, false.

Exceções

Exception	Condition
ArgumentNullException	obj é null. -ou- key é null.
ArgumentException	obj não é um objeto COM. -ou- obj é um objeto Tempo de Execução do Windows.

Comentários

Todos os objetos COM encapsulados em um RCW (Runtime Callable Wrapper) (RCW) tem uma tabela de hash associada, no qual SetComObjectData adiciona dados.Marshal.GetComObjectDatarecupera dados da tabela de hash. Você nunca deve ter que chamar o método do seu código.

Segurança

SecurityCriticalAttribute

requires full trust for the immediate caller. This member cannot be used by partially trusted or transparent code.

Informações de Versão

.NET Framework
Disponível desde 1.1

Confira Também

GetComObjectData
Classe Marshal
Namespace System.Runtime.InteropServices

Retornar ao início

Compartilhar via