Compartir a través de

Función PSStringFromPropertyKey (propsys.h)

  • Artículo

Crea una cadena que identifica una propiedad a partir de la clave de esa propiedad.

Sintaxis

PSSTDAPI PSStringFromPropertyKey(
  [in]  REFPROPERTYKEY pkey,
  [out] LPWSTR         psz,
  [in]  UINT           cch
);

Parámetros

[in] pkey

Tipo: REFPROPERTYKEY

Referencia a una estructura PROPERTYKEY que identifica una propiedad.

[out] psz

Tipo: LPWSTR

Puntero a un búfer que recibe la cadena de salida. El búfer debe ser lo suficientemente grande como para contener PKEYSTR_MAX WCHAR.

[in] cch

Tipo: UINT

Longitud del búfer al que apunta psz, en WCHARs.

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

El formato de cadena recuperado es "{propkey.fmtid} propkey.pid". Por ejemplo, la cadena de salida de PKEY_Title es "{F29F85E0-4FF9-1068-AB91-08002B27B3D9} 2".

Ejemplos

En el ejemplo siguiente, que se va a incluir como parte de un programa más grande, se muestra el uso de PSPropertyKeyFromString.

WCHAR szKey[PKEYSTR_MAX]

HRESULT hr = PSStringFromPropertyKey(PKEY_Title, szKey, ARRAYSIZE(szKey));

if (SUCCEEDED(hr))
{
    // szKey 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

PSGetNameFromPropertyKey

PSPropertyKeyFromString