Compartilhar via


Função PSStringFromPropertyKey (propsys.h)

Cria uma cadeia de caracteres que identifica uma propriedade da chave dessa propriedade.

Sintaxe

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

Parâmetros

[in] pkey

Tipo: REFPROPERTYKEY

Referência a uma estrutura PROPERTYKEY que identifica uma propriedade.

[out] psz

Tipo: LPWSTR

Ponteiro para um buffer que recebe a cadeia de caracteres de saída. O buffer deve ser grande o suficiente para conter PKEYSTR_MAX WCHARs.

[in] cch

Tipo: UINT

O comprimento do buffer apontado por psz, em WCHARs.

Retornar valor

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

O formato de cadeia de caracteres recuperado é "{propkey.fmtid} propkey.pid". Por exemplo, a cadeia de caracteres de saída para PKEY_Title é "{F29F85E0-4FF9-1068-AB91-08002B27B3D9} 2".

Exemplos

O exemplo a seguir, a ser incluído como parte de um programa maior, demonstra o uso de PSPropertyKeyFromString.

WCHAR szKey[PKEYSTR_MAX]

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

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

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP com SP2, Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 com SP1 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho propsys.h
Biblioteca Propsys.lib
DLL Propsys.dll (versão 6.0 ou posterior)
Redistribuível Pesquisa da Área de Trabalho do Windows (WDS) 3.0

Confira também

PSGetNameFromPropertyKey

PSPropertyKeyFromString