Funzione PSPropertyKeyFromString (propsys.h)
Converte una stringa in una struttura PROPERTYKEY .
Sintassi
PSSTDAPI PSPropertyKeyFromString(
[in] LPCWSTR pszString,
[out] PROPERTYKEY *pkey
);
Parametri
[in] pszString
Tipo: LPCWSTR
Puntatore a una stringa Con terminazione Null, stringa Unicode da convertire.
[out] pkey
Tipo: PROPERTYKEY*
Quando questa funzione restituisce, contiene un puntatore a una struttura PROPERTYKEY .
Valore restituito
Tipo: HRESULT
Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .
Commenti
La stringa da convertire deve essere formattata come "{fmtid} pid". Ad esempio, la stringa corrispondente a PKEY_Title è: "{F29F85E0-4FF9-1068-AB91-08002B27B3D9} 2".
PSStringFromPropertyKey restituisce stringhe in questo formato.
Questa funzione ha esito positivo per qualsiasi stringa di chiave di proprietà valida, anche se la proprietà non esiste nello schema delle proprietà.
Esempio
L'esempio seguente, da includere come parte di un programma più ampio, illustra come usare PSPropertyKeyFromString.
PROPERTYKEY key;
HRESULT hr = PSPropertyKeyFromString(L"{F29F85E0-4FF9-1068-AB91-08002B27B3D9} 2", &key);
if (SUCCEEDED(hr))
{
// The key variable is now valid.
}
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP con SP2, Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2003 con SP1 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | propsys.h |
| Libreria | Propsys.lib |
| DLL | Propsys.dll (versione 6.0 o successiva) |
| Componente ridistribuibile | Windows Desktop Search (WDS) 3.0 |