Funzione PSGetPropertySystem (propsys.h)

Ottiene un'istanza dell'oggetto sottosistema che implementa IPropertySystem.

Sintassi

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

Parametri

[in] riid

Tipo: REFIID

Riferimento all'IID dell'interfaccia richiesta.

[out] ppv

Tipo: void**

Quando questa funzione restituisce, contiene il puntatore dell'interfaccia richiesto in riid. Questo è in genere IPropertySystem.

Valore restituito

Tipo: PSSTDAPI

Restituisce uno dei valori seguenti.

Commenti

È necessario inizializzare Il modello a oggetti componente (COM) con CoInitialize o OleInitialize prima di chiamare PSGetPropertySystem. COM deve rimanere inizializzato per la durata di questo oggetto. L'oggetto del sistema delle proprietà aggrega il marshaller senza thread ed è thread-safe.

È consigliabile usare la macro IID_PPV_ARGS definita in Objbase.h per creare il pacchetto dei parametri riid e ppv . Questa macro fornisce l'IID corretto in base all'interfaccia a cui punta il valore in ppv, che elimina la possibilità di un errore di codifica.

Esempio

L'esempio seguente, da includere come parte di un programma più grande, illustra come usare PSGetPropertySystem.

IPropertySystem *pSystem;

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

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

Requisiti