Metodo IOpenControlPanel::GetPath (shobjidl_core.h)

Articolo
03/05/2024

Ottiene il percorso di un elemento Pannello di controllo specificato.

Sintassi

HRESULT GetPath(
  [in]  LPCWSTR pszName,
  [out] LPWSTR  pszPath,
  [in]  UINT    cchPath
);

Parametri

[in] pszName

Tipo: LPCWSTR

Puntatore al nome canonico dell'elemento o al relativo GUID. Questo valore può essere NULL. Per altri dettagli, vedere la sezione Osservazioni. Per un elenco completo dei nomi canonici degli elementi Pannello di controllo, vedere Nomi canonici di elementi Pannello di controllo.

[out] pszPath

Tipo: LPWSTR

Quando termina, questo metodo contiene il percorso dell'elemento Pannello di controllo specificato come stringa Unicode.

[in] cchPath

Tipo: UINT

Dimensioni del buffer a cui punta pszPath, in WCHAR.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Se pszName punta al nome canonico o al GUID dell'elemento, il percorso restituito si trova in una di queste due forme, a seconda della visualizzazione Pannello di controllo più recente (visualizzazione classica o visualizzazione categoria):

::{CLSID_ControlPanel}\::{item guid}
::{CLSID_ControlPanelCategory}\categoryId\::{item guid}

Se pszName è NULL , viene restituito uno di questi due valori:

::{CLSID_ControlPanel}
::{CLSID_ControlPanelCategory}

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)

Vedi anche

Sviluppo per il Pannello di controllo

IOpenControlPanel

Condividi tramite