Compartilhar via

Função PSGetPropertySystem (propsys.h)

  • Artigo

Obtém uma instância do objeto subsistema que implementa IPropertySystem.

Sintaxe

PSSTDAPI PSGetPropertySystem(
  [in]  REFIID riid,
  [out] void   **ppv
);

Parâmetros

[in] riid

Tipo: REFIID

Referência à IID da interface solicitada.

[out] ppv

Tipo: void**

Quando essa função retorna, contém o ponteiro de interface solicitado em riid. Normalmente, isso é IPropertySystem.

Valor retornado

Tipo: PSSTDAPI

Retorna um dos valores a seguir.

Código de retorno Descrição
S_OK
 A interface foi obtida.
E_INVALIDARG
 O parâmetro ppv é NULL.

Comentários

Você deve inicializar o COM (Component Object Model) com CoInitialize ou OleInitialize antes de chamar PSGetPropertySystem. O COM deve permanecer inicializado durante o tempo de vida deste objeto. O objeto do sistema de propriedades agrega o marshaller de thread livre e é thread-safe.

Recomendamos que você use a macro IID_PPV_ARGS definida em Objbase.h para empacotar os parâmetros riid e ppv . Essa macro fornece o IID correto com base na interface apontada pelo valor em ppv, o que elimina a possibilidade de um erro de codificação.

Exemplos

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

IPropertySystem *pSystem;

HRESULT hr = PSGetPropertySystem(IID_PPV_ARGS(&pSystem));

if (SUCCEEDED(hr))
{
    // pSystem is now valid.
 
    pSystem->Release();
}

Requisitos

   
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