Método RegistrationServices.RegisterTypeForComClients (Type, RegistrationClassContext, RegistrationConnectionType)

Artigo
04/20/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.

Registra o tipo especificado com COM usando o contexto de execução e o tipo de conexão especificados.

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

Sintaxe

[SecurityCriticalAttribute]
[ComVisibleAttribute(false)]
public virtual int RegisterTypeForComClients(
    Type type,
    RegistrationClassContext classContext,
    RegistrationConnectionType flags
)

public:
[SecurityCriticalAttribute]
[ComVisibleAttribute(false)]
virtual int RegisterTypeForComClients(
    Type^ type,
    RegistrationClassContext classContext,
    RegistrationConnectionType flags
)

[<SecurityCriticalAttribute>]
[<ComVisibleAttribute(false)>]
abstract RegisterTypeForComClients : 
        type:Type *
        classContext:RegistrationClassContext *
        flags:RegistrationConnectionType -> int
[<SecurityCriticalAttribute>]
[<ComVisibleAttribute(false)>]
override RegisterTypeForComClients : 
        type:Type *
        classContext:RegistrationClassContext *
        flags:RegistrationConnectionType -> int

<SecurityCriticalAttribute>
<ComVisibleAttribute(False)>
Public Overridable Function RegisterTypeForComClients (
    type As Type,
    classContext As RegistrationClassContext,
    flags As RegistrationConnectionType
) As Integer

Parâmetros

type
Type: System.Type

O objeto Type a ser registrado para uso do COM.

classContext
Type: System.Runtime.InteropServices.RegistrationClassContext

Um dos valores RegistrationClassContext que indica o contexto no qual o código executável será executado.

flags
Type: System.Runtime.InteropServices.RegistrationConnectionType

Um dos valores RegistrationConnectionType que especifica como as conexões são feitas com o objeto de classe.

Valor Retornado

Type: System.Int32

Um inteiro que representa um valor de cookie.

Exceções

Exception	Condition
ArgumentException	O parâmetro type é null.
ArgumentNullException	O parâmetro type não pode ser criado.

Comentários

Esse método é equivalente a chamar CoRegisterClassObject em COM. O RegisterTypeForComClients método não é atômico e pode causar resultados imprevisíveis quando usado em um contexto multi-threaded.

No .NET Framework versão 2.0 e posterior, use o UnregisterTypeForComClients método para cancelar o registro de um tipo em COM.

Observe que usando invocação de plataforma para chamar não gerenciado CoRegisterClassObject e CoDisconnectObject não há suporte para métodos de registro e cancelamento de registro de objetos COM.

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 2.0

Confira Também

RegisterTypeForComClients Sobrecarga
Classe RegistrationServices
Namespace System.Runtime.InteropServices

Retornar ao início

Compartilhar via