Fonction PSStringFromPropertyKey (propsys.h)

Crée une chaîne qui identifie une propriété à partir de la clé de cette propriété.

Syntaxe

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

Paramètres

[in] pkey

Type : REFPROPERTYKEY

Référence à une structure PROPERTYKEY qui identifie une propriété.

[out] psz

Type : LPWSTR

Pointeur vers une mémoire tampon qui reçoit la chaîne de sortie. La mémoire tampon doit être suffisamment grande pour contenir PKEYSTR_MAX WCHAR.

[in] cch

Type : UINT

Longueur de la mémoire tampon pointée vers psz, dans WCHARs.

Valeur retournée

Type : HRESULT

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Le format de chaîne récupéré est "{propkey.fmtid} propkey.pid". Par exemple, la chaîne de sortie pour PKEY_Title est "{F29F85E0-4FF9-1068-AB91-08002B27B3D9} 2".

Exemples

L’exemple suivant, à inclure dans le cadre d’un programme plus grand, illustre l’utilisation de PSPropertyKeyFromString.

WCHAR szKey[PKEYSTR_MAX]

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

if (SUCCEEDED(hr))
{
    // szKey is now valid.
}

Configuration requise

Voir aussi

PSGetNameFromPropertyKey

PSPropertyKeyFromString