AfxLoadLibrary

HINSTANCE AFXAPI AfxLoadLibrary (LPCTSTR lpszModuleName);

Valor de retorno

Se a função for bem-sucedido, o valor de retorno é um identificador para o módulo. Se a função falhar, o valor de retorno é NULL.

Parâmetros

lpszModuleName

Aponta para uma seqüência de caracteres null-terminated que contém o nome do módulo (qualquer um.DLL ou.Arquivo EXE). O nome especificado é o nome do arquivo do módulo.

Se a Cadeia de caracteres Especifica um caminho, mas o arquivo não existe no diretório especificado, o função falhar.

Se um caminho não for especificado e a extensão de nome de arquivo for omitida, a extensão padrão.DLL é acrescentado. No entanto, a Cadeia de caracteres de nome de arquivo pode incluir um caractere à direita do ponto (.) para indicar que o nome do módulo não tem extensão. Quando nenhum caminho for especificado, a função procura o arquivo na seqüência a seguir:

• O diretório do qual o aplicativo carregado.
  
  
• O diretório atual.
  
  
• Windows 95: O diretório de sistema do Windows. Windows NT: Diretório de sistema do Windows de 32 bits. O nome deste diretório é SYSTEM32.
  
  
• Somente Windows NT: Diretório de sistema do Windows de 16 bits. Não há nenhuma função de Win32 que obtém o caminho nesse diretório, mas ele é pesquisado. O nome deste diretório é sistema.
  
  
• O diretório do Windows.
  
  
• Os directórios listados na variável de ambiente PATH.

Observações

Use AfxLoadLibrary para mapear um módulo DLL. Ele retorna um identificador que pode ser usado em GetProcAddress para obter o endereço de uma função DLL. AfxLoadLibrary também pode ser usado para mapear outros módulos executáveis.

Cada processo mantém uma contagem de referência para cada módulo carregado biblioteca. Esta contagem de referência é incrementada sempre que AfxLoadLibrary é chamado e é diminuído sempre que AfxFreeLibrary é chamado. Quando o contagem de referência atingir zero, o módulo é não mapeado do espaço de endereço do processo de chamada e o identificador é não mais válido.

Certifique-se de usar AfxLoadLibrary e AfxFreeLibrary (em vez do Win32 funções LoadLibrary e FreeLibrary) se seu aplicativo usa Múltiplo segmentos. Usando AfxLoadLibrary e AfxFreeLibrary garante que o código de inicialização e desligamento que executa quando a extensão DLL é carregada e descarregada não corrompe o estado global do MFC.

Co&nsulte tambémnbsp;AfxFreeLibrary