Função InitPropVariantFromString (propvarutil.h)

Artigo
03/01/2024

Inicializa uma estrutura PROPVARIANT com base em uma cadeia de caracteres especificada.

Sintaxe

HRESULT InitPropVariantFromString(
  [in]  PCWSTR      psz,
  [out] PROPVARIANT *ppropvar
);

Parâmetros

[in] psz

Tipo: PCWSTR

Ponteiro para um buffer que contém a cadeia de caracteres Unicode de origem.

[out] ppropvar

Tipo: PROPVARIANT*

Quando essa função retorna, contém a estrutura PROPVARIANT inicializada.

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

Essa é uma função embutida, com seu código-fonte fornecido no cabeçalho . Ele não está incluído em nenhum arquivo .dll ou .lib.

Exemplos

O exemplo a seguir, a ser incluído como parte de um programa maior, demonstra como usar InitPropVariantFromString.

PROPVARIANT propvar;
HRESULT hr = InitPropVariantFromString(L"Hello World", &propvar);

if (SUCCEEDED(hr))
{
    // propvar now is valid and has type VT_LPWSTR.
    PropVariantClear(&propvar);
}

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	propvarutil.h
Redistribuível	Pesquisa da Área de Trabalho do Windows (WDS) 3.0