QueryFullProcessImageNameA-Funktion (winbase.h)

  • Artikel

Ruft den vollständigen Namen des ausführbaren Images für den angegebenen Prozess ab.

Syntax

BOOL QueryFullProcessImageNameA(
  [in]      HANDLE hProcess,
  [in]      DWORD  dwFlags,
  [out]     LPSTR  lpExeName,
  [in, out] PDWORD lpdwSize
);

Parameter

[in] hProcess

Ein Handle für den Prozess. Dieses Handle muss mit dem Zugriffsrecht PROCESS_QUERY_INFORMATION oder PROCESS_QUERY_LIMITED_INFORMATION erstellt werden. Weitere Informationen finden Sie unter Prozesssicherheit und Zugriffsrechte.

[in] dwFlags

Dieser Parameter kann einen der folgenden Werte annehmen.

Wert Bedeutung
0
 Der Name sollte das Win32-Pfadformat verwenden.
PROCESS_NAME_NATIVE
0x00000001
 Der Name sollte das systemeigene Systempfadformat verwenden.

[out] lpExeName

Der Pfad zum ausführbaren Image. Wenn die Funktion erfolgreich ist, ist diese Zeichenfolge null-beendet.

[in, out] lpdwSize

Gibt bei der Eingabe die Größe des puffers lpExeName in Zeichen an. Empfängt bei Erfolg die Anzahl von Zeichen, die in den Puffer geschrieben wurden, ohne das NULL-Endzeichen.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Um eine Anwendung zu kompilieren, die diese Funktion verwendet, definieren Sie _WIN32_WINNT als 0x0600 oder höher.

Hinweis

Der winbase.h-Header definiert QueryFullProcessImageName als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winbase.h (Windows.h einschließen)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

GetModuleFileNameEx

GetProcessImageFileName

Prozess- und Threadfunktionen