PSPropertyKeyFromString-Funktion (propsys.h)
Konvertiert eine Zeichenfolge in eine PROPERTYKEY-Struktur .
Syntax
PSSTDAPI PSPropertyKeyFromString(
[in] LPCWSTR pszString,
[out] PROPERTYKEY *pkey
);
Parameter
[in] pszString
Typ: LPCWSTR
Zeiger auf eine unicode-Zeichenfolge, die mit NULL beendet wird, die konvertiert werden soll.
[out] pkey
Typ: PROPERTYKEY*
Wenn diese Funktion zurückgibt, enthält einen Zeiger auf eine PROPERTYKEY-Struktur .
Rückgabewert
Typ: HRESULT
Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Die zu konvertierende Zeichenfolge muss als "{fmtid} pid"formatiert sein. Für instance ist die Zeichenfolge, die entsprichtPKEY_Title: "{F29F85E0-4FF9-1068-AB91-08002B27B3D9} 2".
PSStringFromPropertyKey gibt Zeichenfolgen in diesem Format aus.
Diese Funktion ist für jede gültige Eigenschaftsschlüsselzeichenfolge erfolgreich, auch wenn die Eigenschaft im Eigenschaftenschema nicht vorhanden ist.
Beispiele
Im folgenden Beispiel, das als Teil eines größeren Programms eingeschlossen werden soll, wird die Verwendung von PSPropertyKeyFromString veranschaulicht.
PROPERTYKEY key;
HRESULT hr = PSPropertyKeyFromString(L"{F29F85E0-4FF9-1068-AB91-08002B27B3D9} 2", &key);
if (SUCCEEDED(hr))
{
// The key variable is now valid.
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP mit SP2, Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 mit SP1 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | propsys.h |
| Bibliothek | Propsys.lib |
| DLL | Propsys.dll (Version 6.0 oder höher) |
| Verteilbare Komponente | Windows Desktop Search (WDS) 3.0 |