Função GetSystemWow64Directory2W (wow64apiset.h)

Artigo
11/20/2024

Recupera o caminho do diretório do sistema usado por WOW64 usando o tipo de computador de arquivo de imagem especificado. Esse diretório não está presente no Windows de 32 bits.

Sintaxe

UINT GetSystemWow64Directory2W(
  [out] LPWSTR lpBuffer,
  [in]  UINT   uSize,
  [in]  WORD   ImageFileMachineType
);

Parâmetros

[out] lpBuffer

Um ponteiro para o buffer para receber o caminho. Esse caminho não termina com uma barra invertida.

[in] uSize

O tamanho máximo do buffer, em TCHARs.

[in] ImageFileMachineType

Um valor IMAGE_FILE_MACHINE_* que especifica o computador a ser testado.

Valor de retorno

Se a função for bem-sucedida, o valor retornado será o comprimento, em TCHARs, da cadeia de caracteres copiada para o buffer, não incluindo o caractere nulo de terminação. Se o comprimento for maior que o tamanho do buffer, o valor retornado será o tamanho do buffer necessário para manter o caminho.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Observações

Em sistemas que dão suporte a várias arquiteturas de WOW64 , você pode usar GetSystemWow64Directory2 para recuperar o diretório do sistema apropriado associado à arquitetura WOW64 especificada por ImageFileMachineType.

O WOW64 usa o diretório do sistema para armazenar o código compartilhado de 32 bits no Windows de 64 bits. A maioria dos aplicativos não precisa acessar esse diretório explicitamente.

Para obter mais informações sobre o WOW64, consulte Executando aplicativos de 32 bits.

Nota

O cabeçalho wow64apiset.h define GetSystemWow64Directory2 como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 10, versão 1511 [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2016 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	wow64apiset.h
biblioteca	Kernel32.dll
de DLL	Kernel32.lib

Consulte também

GetSystemWow64Directory

Compartilhar via