GetWindowsDirectory

[funkcja] Zwraca ścieżkę do głównego katalogu Windows.

Składnia

#include <windows.h>

WINBASEAPI UINT WINAPI GetWindowsDirectory(
LPTSTR lpBuffer,
UINT uSize
);

Argumenty

Argument	Opis
LPTSTR lpBuffer	Wskaźnik na bufor, który otrzyma ścieżkę. Nie jest ona zakończona backslashem, chyba że system został zainstalowany na katalogu podstawowym (np. C:\).
UINT uSize	Długość bufora podanego w argumencie lpBuffer

Zwracana wartość

Jeżeli wywołanie funkcji powiedzie się, zwróci ona długość znaków skopiowanych do bufora. Jeśli bufor jest za mały, funkcja zwróci długość potrzebną do otrzymania ścieżki. Jeśli funkcja zakończy swoje działanie niepowodzeniem, zwrócona wartość będzie wynosiła 0. Aby uzyskać szczegółowe informacje o błędzie, użyj _{» WinAPI ♦}GetLastError.

Opis szczegółowy

Funkcja GetWindowsDirectory zwraca ścieżkę do głównego katalogu Windows.

Nowe aplikacje nie powinny zapisywać plików w katalogu Windows. Do tego celu należy użyć ścieżki instalacyjnej albo katalogu użytkownika.

Przykładowa funkcja wyświetlająca na ekranie za pomocą funkcji MessageBox ścieżkę do katalogu Windows:

void AlertWindowsDirectory( void )
{
char * buf;
int length = GetWindowsDirectory( buf, 0 );
buf = new char[ length ];
GetWindowsDirectory( buf, length );
MessageBox( 0, buf, 0, 0 );
delete[] buf;
}

Wymagania

Minimalny obsługiwany klient	Windows 2000 Professional
Minimalny obsługiwany serwer	Windows 2000 Server
Nagłówek	Winbase.h (wewnątrz Windows.h)
Biblioteka	Kernel32.lib
DLL	Kernel.dll
Nazwy Unicode i ANSI	GetWindowsDirectoryW (Unicode) i GetWindowsDirectoryA (ANSI)

Linki zewnętrzne

http://msdn.microsoft.com/en-us/library/windows/desktop/ms724454(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.