Shgetfolderpathex-Funktion
BESCHREIBUNG
[Einige Informationen beziehen sich auf Vorabversionen, die vor der kommerziellen Freigabe grundlegend geändert werden können. Microsoft übernimmt keine Garantie, weder ausdrücklich noch stillschweigend, für die hier bereitgestellten Informationen.]
Ruft den vollständigen Pfad eines bekannten Ordners ab, der durch die KNOWNFOLDERIDdes Ordners identifiziert wird. Dadurch wird " shgetknownfolderpath " erweitert, indem Sie die anfängliche Größe des Zeichen folgen Puffers festlegen können.
HRESULT WINAPI SHGetFolderPathEx(
_In_ REFKNOWNFOLDERID rfid,
_In_ DWORD dwFlags,
_In_opt_ HANDLE hToken,
_Out_ LPWSTR pszPath,
_In_ UINT cchPath
);
Parameter
RFID [in]
Ein Verweis auf die KNOWNFOLDERID , die den Ordner identifiziert.
dwFlags [in]
Flags, die besondere Abruf Optionen angeben. Dieser Wert kann 0 sein. andernfalls ein oder mehrere der KNOWN_FOLDER_FLAG Werte.
hToken [in, optional]
Ein Zugriffs Token , das einen bestimmten Benutzer darstellt. Wenn dieser Parameter null ist, was die häufigste Verwendung ist, fordert die Funktion den bekannten Ordner für den aktuellen Benutzer an.
Fordern Sie den Ordner eines bestimmten Benutzers an, indem Sie das hToken dieses Benutzers übergeben. Dies erfolgt in der Regel im Kontext eines Diensts, der über ausreichende Berechtigungen zum Abrufen des Tokens eines bestimmten Benutzers verfügt. Dieses Token muss mit TOKEN_QUERY und TOKEN_IMPERSONATE Rechten geöffnet werden. In einigen Fällen müssen Sie auch TOKEN_DUPLICATEeinschließen. Zusätzlich zum Übergeben des htokens des Benutzers muss die Registrierungs Struktur dieses bestimmten Benutzers eingebunden werden. Weitere Informationen zu Zugriffs Steuerungsproblemen finden Sie unter Access Control .
Beim Zuweisen des hToken -Parameters wird der Wert-1 für den Standardbenutzer angegeben. Dies ermöglicht es Clients von shgetknownfolderpath , Ordner Speicherorte (z. b. den Desktop Ordner) für den Standardbenutzer zu suchen. Das Standardbenutzer Profil wird dupliziert, wenn ein neues Benutzerkonto erstellt wird, und enthält spezielle Ordner, z. b. Dokumente und Desktop. Alle Elemente, die dem Standardbenutzer Ordner hinzugefügt werden, werden auch in jedem neuen Benutzerkonto angezeigt. Beachten Sie, dass für den Zugriff auf die Standardbenutzer Ordner Administratorrechte erforderlich sind.
pszpath [out]
Eine NULL terminierte Unicode-Zeichenfolge. Dieser Puffer muss die Größe cchpath aufweisen. Wenn " shgetfolderpathex " erfolgreich zurückgegeben wird, enthält dieser Parameter den Pfad für den bekannten Ordner.
cchpath [in]
Die Größe des ppszpath -Puffers in Zeichen.
Gibt zurück
Gibt S_OK zurück, wenn erfolgreich, oder andernfalls einen Fehlerwert.
Bemerkungen
Da SHGetFolderPath ein Wrapper für shgetknownfolderpathist, fungiert diese Funktion (shgetfolderpathex) auch als Erweiterung von SHGetFolderPath.