Función PSPropertyKeyFromString (propsys.h)
Convierte una cadena en una estructura PROPERTYKEY .
Sintaxis
PSSTDAPI PSPropertyKeyFromString(
[in] LPCWSTR pszString,
[out] PROPERTYKEY *pkey
);
Parámetros
[in] pszString
Tipo: LPCWSTR
Puntero a una cadena Unicode terminada en null que se va a convertir.
[out] pkey
Tipo: PROPERTYKEY*
Cuando esta función devuelve, contiene un puntero a una estructura PROPERTYKEY .
Valor devuelto
Tipo: HRESULT
Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
La cadena que se va a convertir debe tener el formato "{fmtid} pid". Por ejemplo, la cadena que corresponde a PKEY_Title es: "{F29F85E0-4FF9-1068-AB91-08002B27B3D9} 2".
PSStringFromPropertyKey genera cadenas en este formato.
Esta función se realiza correctamente para cualquier cadena de clave de propiedad válida, incluso si la propiedad no existe en el esquema de propiedades.
Ejemplos
En el ejemplo siguiente, para incluirse como parte de un programa más grande, se muestra cómo usar PSPropertyKeyFromString.
PROPERTYKEY key;
HRESULT hr = PSPropertyKeyFromString(L"{F29F85E0-4FF9-1068-AB91-08002B27B3D9} 2", &key);
if (SUCCEEDED(hr))
{
// The key variable is now valid.
}
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP con SP2, Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 con SP1 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | propsys.h |
| Library | Propsys.lib |
| Archivo DLL | Propsys.dll (versión 6.0 o posterior) |
| Redistribuible | Búsqueda de escritorio de Windows (WDS) 3.0 |