IOpenControlPanel::GetPath-Methode (shobjidl_core.h)
Ruft den Pfad eines angegebenen Systemsteuerung-Elements ab.
Syntax
HRESULT GetPath(
[in] LPCWSTR pszName,
[out] LPWSTR pszPath,
[in] UINT cchPath
);
Parameter
[in] pszName
Typ: LPCWSTR
Ein Zeiger auf den kanonischen Namen des Elements oder seine GUID. Dieser Wert kann NULL sein. Weitere Informationen finden Sie unter Hinweise. Eine vollständige Liste Systemsteuerung kanonischen Elementnamen finden Sie unter Kanonische Namen von Systemsteuerung Items.
[out] pszPath
Typ: LPWSTR
Wenn diese Methode zurückgibt, enthält den Pfad des angegebenen Systemsteuerung Elements als Unicode-Zeichenfolge.
[in] cchPath
Typ: UINT
Die Größe des Puffers, auf den pszPath in WCHARs verweist.
Rückgabewert
Typ: HRESULT
Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Wenn pszName auf den kanonischen Namen oder die GUID des Elements verweist, befindet sich der zurückgegebene Pfad in einer dieser beiden Formen, abhängig von der neuesten Systemsteuerung Ansicht (klassische Ansicht oder Kategorieansicht):
::{CLSID_ControlPanel}\::{item guid}
::{CLSID_ControlPanelCategory}\categoryId\::{item guid}
Wenn pszNameNULL ist, wird einer der folgenden beiden Werte zurückgegeben:
::{CLSID_ControlPanel}
::{CLSID_ControlPanelCategory}
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | shobjidl_core.h (shobjidl.h einschließen) |