GetAllUsersProfileDirectoryW-Funktion (userenv.h)
Ruft den Pfad zum Stammverzeichnis des Verzeichnisses ab, das programmdaten enthält, die von allen Benutzern freigegeben werden.
Syntax
USERENVAPI BOOL GetAllUsersProfileDirectoryW(
[out, optional] LPWSTR 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 empfängt. Legen Sie diesen Wert auf NULL- fest, um die erforderliche Größe des Puffers zu ermitteln, einschließlich des endenden Nullzeichens.
[in, out] lpcchSize
Typ: LPDWORD-
Ein Zeiger auf die Größe des lpProfileDir- Puffers in TCHARs.
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 GetAllUsersProfileDirectory- in Windows XP zurückgegeben wird:
C:\Documents and Settings\All Users
Es folgt ein Beispiel für den Pfad, der von GetAllUsersProfileDirectory- in Windows 7 zurückgegeben wird:
C:\ProgramData
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 GetAllUsersProfileDirectory 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