SHGetFolderPathEx-Funktion

BESCHREIBUNG

[Einige Informationen beziehen sich auf die Vorabversion, die vor der kommerziellen Freigabe möglicherweise wesentlichen Änderungen unterliegt. Microsoft übernimmt für die hier bereitgestellten Informationen keine Gewährleistung, weder ausdrücklicher noch impliziter Art.]

Ruft den vollständigen Pfad eines bekannten Ordners ab, der durch die KNOWNFOLDERID des Ordners identifiziert wird. Dadurch wird SHGetKnownFolderPath erweitert, indem Sie die anfängliche Größe des Zeichenfolgenpuffers 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 spezielle Abrufoptionen angeben. Dieser Wert kann 0 sein. andernfalls mindestens einer der KNOWN_FOLDER_FLAG Werte.

hToken [in, optional]

Ein Zugriffstoken , 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 geschieht 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_DUPLICATE einschließen. Zusätzlich zum Übergeben des hTokens des Benutzers muss die Registrierungsstruktur dieses bestimmten Benutzers eingebunden werden. Weitere Informationen zu Zugriffssteuerungsproblemen finden Sie unter Access Control.

Das Zuweisen des hToken-Parameters mit dem Wert -1 gibt den Standardbenutzer an. Dadurch können Clients von SHGetKnownFolderPath Ordnerspeicherorte (z. B. den Ordner Desktop ) für den Standardbenutzer finden. Das Standardbenutzerprofil wird dupliziert, wenn ein neues Benutzerkonto erstellt wird, und enthält spezielle Ordner wie Dokumente und Desktop. Alle Elemente, die dem Ordner Standardbenutzer hinzugefügt wurden, werden auch in jedem neuen Benutzerkonto angezeigt. Beachten Sie, dass für den Zugriff auf die Standardbenutzerordner Administratorrechte erforderlich sind.

pszPath [out]

Eine Unicode-Zeichenfolge mit Null-Endung. 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 bei erfolgreicher Ausführung S_OK oder andernfalls einen Fehlerwert zurück.

Bemerkungen

Da SHGetFolderPath ein Wrapper für SHGetKnownFolderPath ist, dient diese Funktion (SHGetFolderPathEx) auch als Erweiterung für SHGetFolderPath.

Siehe auch

KNOWNFOLDERID

KNOWN_FOLDER_FLAG

SHGetFolderPath

SHGetKnownFolderIDList

SHGetKnownFolderPath