GetProcAddress

Windows Mobile SupportedWindows Embedded CE Supported

9/8/2008

Essa função retorna o endereço da função de DLL exportado especificado.

Syntax

FARPROC GetProcAddress(
  HMODULE hModule,
  LPCWSTR lpProcName
);

Parameters

  • hModule
    [no] Identificador para o módulo DLL que contém a função.

    O LoadLibrary ou a função GetModuleHandle retornará esse identificador.

  • lpProcName
    [no] Ponteiro para uma seqüência de caracteres NULL-Terminated que contém o nome função, ou especifica ordinal da função de valor.

    Se este parâmetro é um ordinal valor, ele deve estar de baixo-palavra ordem; o alto-palavra ordem deve ser zero.

    Este parâmetro deve estar em Unicode.

Return Value

O endereço da função exportada do DLL indica sucesso. NULL Indica falha. Para informações de erro estendidas get, chamar GetLastError.

Remarks

Windows CE 3.0 e posterior, a versão ASCII desta função, GetProcAddressAEste parâmetro adicional tem suporte. Com esta versão, lpProcName é o tipo de LPCSTR.

O GetProcAddress função é usada para recuperar endereços de Exportadas funções em DLLs.

O ortográfico e maiúsculas e minúsculas do nome da função apontado pelo lpProcName deve ser idêntico ao que in a Exports declaração da origem módulo do DLL-arquivo definição (.DEF).

Os nomes exportados de APIs Win32 podem diferem dos nomes a você usa quando chamado essas funções em seu codificar. Esta diferença está oculto por macros utilizadas nos arquivos de cabeçalho SDK.

O lpProcName parâmetro pode identificar o função de DLL, especificando um ordinal valor associado com a função in a Exports declaração.

GetProcAddress Verifica se o ordinal especificado está no intervalo 1 através o ordinal mais alto valor exportados no arquivo .def.

A função, em seguida, usa o ordinal como um índice ao ler endereço da função de uma tabela função.

Se o arquivo .def não número de funções consecutivamente de 1 a N (onde N é o número de funções exportadas), um erro pode ocorrer onde GetProcAddress Retorna um inválido, endereço nonnull, mesmo que não haja nenhuma função com o ordinal especificado.

Em casos onde a função pode não existir, a função deve ser especificada por nome em vez de por ordinal valor.

Ao utilizar a GetProcAddress Para obter o endereço das InitSecurityInterface função, usar SECURITY_ENTRYPOINT para lpProcName.

Requirements

Header winbase.h
Library coredll.lib
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

DLL Functions
FreeLibrary
GetModuleHandle
LoadLibrary