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

Vedi anche

PSGetPropertyKeyFromName

PSStringFromPropertyKey