GetDefaultUserProfileDirectoryA-Funktion (userenv.h)
Ruft den Pfad zum Stammverzeichnis des Profils des Standardbenutzers ab.
Syntax
USERENVAPI BOOL GetDefaultUserProfileDirectoryA(
[out, optional] LPSTR lpProfileDir,
[in, out] LPDWORD lpcchSize
);
Parameter
[out, optional] lpProfileDir
Typ: LPTSTR-
Ein Zeiger auf einen Puffer, der, wenn diese Funktion erfolgreich zurückgegeben wird, den Pfad zum Profilverzeichnis des Standardbenutzers 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 lpProfileDir- Puffers in TCHARs-an.
Wenn der durch lpProfileDir angegebene Puffer nicht groß genug ist oder lpProfileDir-NULL-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 GetDefaultUserProfileDirectory in Windows XP zurückgegeben wird:
C:\Documents and Settings\Default User
Es folgt ein Beispiel für den Pfad, der von GetDefaultUserProfileDirectory in Windows 7 zurückgegeben wird:
C:\Users\Default
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 GetDefaultUserProfileDirectory 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
übersicht über Benutzerprofile