GetSystemWow64Directory2W, fonction (wow64apiset.h)

  • Article

Récupère le chemin d’accès du répertoire système utilisé par WOW64, à l’aide du type de machine de fichier image spécifié. Ce répertoire n’est pas présent sur Windows 32 bits.

Syntaxe

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

Paramètres

[out] lpBuffer

Pointeur vers la mémoire tampon pour recevoir le chemin d’accès. Ce chemin ne se termine pas par une barre oblique inverse.

[in] uSize

Taille maximale de la mémoire tampon, en TCHAR.

[in] ImageFileMachineType

Valeur IMAGE_FILE_MACHINE_* qui spécifie la machine à tester.

Valeur retournée

Si la fonction réussit, la valeur de retour est la longueur, en TCHAR, de la chaîne copiée dans la mémoire tampon, sans inclure le caractère null de fin. Si la longueur est supérieure à la taille de la mémoire tampon, la valeur de retour correspond à la taille de la mémoire tampon requise pour contenir le chemin d’accès.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Sur les systèmes qui prennent en charge plusieurs architectures WOW64 , vous pouvez utiliser GetSystemWow64Directory2 pour récupérer le répertoire système approprié associé à l’architecture WOW64 spécifiée par ImageFileMachineType.

WOW64 utilise le répertoire système pour stocker du code 32 bits partagé sur Windows 64 bits. La plupart des applications n’ont pas besoin d’accéder explicitement à ce répertoire.

Pour plus d’informations sur WOW64, consultez Exécution d’applications 32 bits.

Notes

L’en-tête wow64apiset.h définit GetSystemWow64Directory2 comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10, version 1511 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2016 (applications de bureau uniquement)
Plateforme cible Windows
En-tête wow64apiset.h
Bibliothèque Kernel32.dll
DLL Kernel32.lib

Voir aussi

GetSystemWow64Directory