GetProfilesDirectoryA-Funktion (userenv.h)
Ruft den Pfad zum Stammverzeichnis ab, in dem Benutzerprofile gespeichert sind.
Syntax
USERENVAPI BOOL GetProfilesDirectoryA(
[out] LPSTR lpProfileDir,
[in, out] LPDWORD lpcchSize
);
Parameter
[out] lpProfileDir
Typ: LPTSTR-
Ein Zeiger auf einen Puffer, der, wenn diese Funktion erfolgreich zurückgegeben wird, den Pfad zum Profilverzeichnis empfängt. Legen Sie diesen Wert auf NULL- fest, um die erforderliche Größe des Puffers zu ermitteln.
[in, out] lpcchSize
Typ: LPDWORD-
Gibt die Größe des lpProfilesDir- Puffers in TCHARs-an.
Wenn der durch lpProfilesDir angegebene Puffer nicht groß genug ist oder lpProfilesDirNULL-ist, schlägt die Funktion fehl, und dieser Parameter empfängt die erforderliche Puffergröße, einschließlich des endierenden NULL-Zeichens.
Rückgabewert
Typ: BOOL-
TRUE bei erfolgreicher Ausführung; andernfalls FALSE. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Bemerkungen
Es folgt ein Beispiel für den Pfad, der von GetProfilesDirectory- in Windows XP zurückgegeben wird:
C:\Documents and Settings
Es folgt ein Beispiel für den Pfad, der von GetProfilesDirectory- in Windows 7 zurückgegeben wird:
C:\Users
Um die Pfade von Unterverzeichnissen dieses Verzeichnisses abzurufen, verwenden Sie die SHGetFolderPath- (Windows XP und früher) oder SHGetKnownFolderPath (Windows Vista)-Funktion.
Anmerkung
Der Header "userenv.h" definiert GetProfilesDirectory 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 |
|---|---|
| mindestens unterstützte Client- | Windows 2000 Professional [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | userenv.h |
| Library | Userenv.lib |
| DLL- | Userenv.dll |
Siehe auch
GetDefaultUserProfileDirectory
übersicht über Benutzerprofile