Compartilhar via

Função PropVariantToGUID (propvarutil.h)

  • Artigo

Extrai um valor GUID de uma estrutura PROPVARIANT .

Sintaxe

PSSTDAPI PropVariantToGUID(
  [in]  REFPROPVARIANT propvar,
  [out] GUID           *pguid
);

Parâmetros

[in] propvar

Tipo: REFPROPVARIANT

Referência a uma estrutura PROPVARIANT de origem .

[out] pguid

Tipo: GUID*

Quando essa função retorna, contém o valor da propriedade extraída, se houver.

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 função auxiliar funciona para estruturasPROPVARIANT dos seguintes tipos:

  • VT_GUID
  • VT_BSTR
  • VT_LPWSTR
  • VT_ARRAY | VT_UI1

PropVariantToGUID é usado em locais onde o aplicativo de chamada espera que um PROPVARIANT mantenha um único valor GUID ou GUID . Por exemplo, um aplicativo que obtém valores de um repositório de propriedades pode usá-lo para extrair com segurança o valor guid para propriedades GUID .

Exemplos

// IPropertyStore *ppropstore;

// Assume variable ppropstore is initialized and valid

PROPVARIANT propvar = {0};

HRESULT hr = ppropstore->GetValue(PKEY_Sync_HandlerCollectionID, &propvar);

if (SUCCEEDED(hr))

{

        // PKEY_Sync_HandlerCollectionID is expected to produce a VT_CLSID or VT_EMPTY value.

        // PropVariantToGUID will convert VT_EMPTY to a failure code.

        GUID guidCollectionID;

        hr = PropVariantToGUID(propvar, &guidCollectionID);

        if (SUCCEEDED(hr))

        {

             // guidCollectionID is now valid

        }

        else

        {

            // the extraction failed

        }

        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
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

InitPropVariantFromCLSID

PropVariantToCLSID

VariantToGUID