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

Consulte también

PSGetPropertyKeyFromName

PSStringFromPropertyKey