Share via

Função PSPropertyKeyFromString (propsys.h)

  • Artigo

Converte uma cadeia de caracteres em uma estrutura PROPERTYKEY .

Sintaxe

PSSTDAPI PSPropertyKeyFromString(
  [in]  LPCWSTR     pszString,
  [out] PROPERTYKEY *pkey
);

Parâmetros

[in] pszString

Tipo: LPCWSTR

Ponteiro para uma cadeia de caracteres Unicode terminada em nulo a ser convertida.

[out] pkey

Tipo: PROPERTYKEY*

Quando essa função retorna, contém um ponteiro para uma estrutura PROPERTYKEY .

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

A cadeia de caracteres a ser convertida deve ser formatada como "{fmtid} pid". Por exemplo, a cadeia de caracteres que corresponde a PKEY_Title é: "{F29F85E0-4FF9-1068-AB91-08002B27B3D9} 2". PSStringFromPropertyKey gera cadeias de caracteres nesse formato.

Essa função é bem-sucedida para qualquer cadeia de caracteres de chave de propriedade válida, mesmo que a propriedade não exista no esquema de propriedade.

Exemplos

O exemplo a seguir, a ser incluído como parte de um programa maior, demonstra como 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 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

PSGetPropertyKeyFromName

PSStringFromPropertyKey