GetModuleFileName

[funkcja] Pobiera pełną ścieżkę do pliku, który zawiera wskazany moduł.

Składnia

#include <windows.h>

DWORD WINAPI GetModuleFileName(
HMODULE hModule,
LPTSTR lpFilename,
DWORD nSize
);

Argumenty

Argument	Opis
HMODULE hModule	Uchwyt do załadowanego modułu, którego chcemy odczytać ścieżkę. Jeśli wartość tego argumentu zostanie ustawiona na `NULL` to funkcja zwróci ścieżkę do pliku wykonywalnego aktualnego procesu.
LPTSTR lpFilename	Wskaźnik na bufor do którego zostanie zapisana ścieżka.
DWORD nSize	Rozmiar bufora wyrażony w liczbie znaków (`TCHAR`).

Zwracana wartość

Zwraca liczbę skopiowanych znaków do bufora (nie licząc znaku terminalnego) w przypadku sukcesu. Jeżeli bufor wyjściowy jest zbyt mały aby pomieścić ścieżkę to funkcja:

ucina kopiowany łańcuch do nSize znaków (łańcuch będzie zakończony znakiem terminalnym);
ustawia kod błędu na ERROR_INSUFFICIENT_BUFFER;
zwraca wartość przekazaną przez argument nSize.

Funkcja zwraca wartość 0 w przypadku wystąpienia innego błędu. Aby otrzymać rozszerzone informacje o błędzie, wywołaj funkcję _{» WinAPI ♦}GetLastError.

Opis szczegółowy

Funkcja pobiera pełną ścieżkę do pliku, który zawiera wskazany moduł. Wskazany moduł musi być załadowany przez aktualny proces. Aby określić ścieżki do modułów innego procesu, użyj funkcji GetModuleFileNameEx.

W przypadku gdy moduł DLL jest załadowany przez dwa różne procesy, to ścieżka do niego w jednym z procesów może się różnić w stosunku do tej w drugim procesie.

Wymagania

Minimalny obsługiwany klient	Windows 2000 Professional
Minimalny obsługiwany serwer	Windows 2000 Server
Biblioteka	kernel32.lib
DLL	kernel32.dll

Przykład

#include <windows.h>
#include <cstdio>

int main()
{
char buffer[ MAX_PATH ];
::GetModuleFileNameA( NULL, buffer, MAX_PATH );
printf( "path: %s\n", buffer );
return 0;
}

Linki zewnętrzne

http://msdn.microsoft.com/en-us/library/windows/desktop/ms683197(v=vs.85).aspx

Wszystkie teksty są chronione prawami autorskimi. Kopiowanie lub rozpowszechnianie treści poza niniejszym serwisem jest zabronione.

Powyższe ograniczenie nie dotyczy autora opracowania, któremu przysługuje prawo do rozpowszechniania własnego tekstu wedle własnego uznania.