QueryFullProcessImageNameA-Funktion (winbase.h)
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 |
---|---|
|
Der Name sollte das Win32-Pfadformat verwenden. |
|
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 |