DefaultDllImportSearchPathsAttribute Classe

Definição

Namespace:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Origem:

DefaultDllImportSearchPathsAttribute.cs

Especifica os caminhos que são usados para procurar DLLs que fornecem funções para invocações de plataforma.

public ref class DefaultDllImportSearchPathsAttribute sealed : Attribute

[System.AttributeUsage(System.AttributeTargets.Assembly | System.AttributeTargets.Method, AllowMultiple=false)]
public sealed class DefaultDllImportSearchPathsAttribute : Attribute

[<System.AttributeUsage(System.AttributeTargets.Assembly | System.AttributeTargets.Method, AllowMultiple=false)>]
type DefaultDllImportSearchPathsAttribute = class
    inherit Attribute

Public NotInheritable Class DefaultDllImportSearchPathsAttribute
Inherits Attribute

Herança

Object

Attribute

DefaultDllImportSearchPathsAttribute

Atributos

AttributeUsageAttribute

Comentários

Quando aplicado a um assembly, esse atributo especifica os caminhos que são usados por padrão para pesquisar qualquer DLL que forneça uma função para uma invocação de plataforma, em qualquer código no assembly. Quando aplicado a uma invocação de plataforma individual, esse atributo substitui os caminhos de pesquisa padrão especificados para o assembly.

Esse atributo é ignorado para qualquer invocação de plataforma que especifique um caminho absoluto.

Use esse atributo para impedir que a função Win32 LoadLibraryEx pesquise o diretório de trabalho atual. Isso ajuda a proteger seu aplicativo contra ataques em que software mal-intencionado coloca uma DLL no diretório de trabalho atual, de modo que, quando uma invocação de plataforma chama a função Win32 LoadLibraryEx , a ordem de pesquisa padrão da função localiza a DLL mal-intencionada em vez da DLL do sistema que ela pretendia localizar.

O Common Language Runtime manipula a chamada para a função LoadLibraryEx de acordo com o seguinte algoritmo:

1. Se o atributo for aplicado a uma invocação de plataforma individual, use os valores especificados por essa instância do atributo.

2. Caso contrário, se o atributo for aplicado ao assembly que contém a invocação de plataforma, use os valores especificados por essa instância do atributo.

3. Caso contrário, pesquise o diretório do assembly e chame a LoadLibraryEx função com o LOAD_WITH_ALTERED_SEARCH_PATH sinalizador .

Esse atributo não tem efeito em plataformas não Windows ou no runtime mono.

Construtores

DefaultDllImportSearchPathsAttribute(DllImportSearchPath)

Inicializa uma nova instância da classe DefaultDllImportSearchPathsAttribute, especificando os caminhos a serem usados ao pesquisar os destinos de invocações de plataforma.

Propriedades

Paths	Obtém uma combinação bit a bit de valores de enumeração que especificam os caminhos que a LoadLibraryEx função pesquisa durante invocações de plataforma.
TypeId	Quando implementado em uma classe derivada, obtém um identificador exclusivo para este Attribute. (Herdado de Attribute)

Métodos

Equals(Object)	Retorna um valor que indica se essa instância é igual a um objeto especificado. (Herdado de Attribute)
GetHashCode()	Retorna o código hash para a instância. (Herdado de Attribute)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
IsDefaultAttribute()	Quando substituído em uma classe derivada, indica se o valor dessa instância é o valor padrão para a classe derivada. (Herdado de Attribute)
Match(Object)	Quando substituído em uma classe derivada, retorna um valor que indica se essa instância é igual a um objeto especificado. (Herdado de Attribute)
MemberwiseClone()	Cria uma cópia superficial do Object atual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Confira também

• DllImportSearchPath
• LoadLibraryEx