Funzione PSGetPropertySystem (propsys.h)

Articolo
08/25/2023

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.

Codice restituito	Descrizione
S_OK	L'interfaccia è stata ottenuta.
E_INVALIDARG	Il parametro ppv è NULL.

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


Client minimo supportato	Windows XP con SP2, Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 con SP1 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	propsys.h
Libreria	Propsys.lib
DLL	Propsys.dll (versione 6.0 o successiva)
Componente ridistribuibile	Windows Desktop Search (WDS) 3.0

Condividi tramite