Fonction PSGetPropertySystem (propsys.h)

Article
08/25/2023

Obtient une instance de l’objet de sous-système qui implémente IPropertySystem.

Syntaxe

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

Paramètres

[in] riid

Type : REFIID

Référence à l’IID de l’interface demandée.

[out] ppv

Type : void**

Lorsque cette fonction retourne, contient le pointeur d’interface demandé dans riid. Il s’agit généralement d’IPropertySystem.

Valeur retournée

Type : PSSTDAPI

Retourne l’une des valeurs suivantes.

Code de retour	Description
S_OK	L’interface a été obtenue.
E_INVALIDARG	Le paramètre ppv est NULL.

Notes

Vous devez initialiser com (Component Object Model) avec CoInitialize ou OleInitialize avant d’appeler PSGetPropertySystem. COM doit rester initialisé pendant toute la durée de vie de cet objet. L’objet système de propriété agrège le marshaleur à thread libre et est thread-safe.

Nous vous recommandons d’utiliser la macro IID_PPV_ARGS définie dans Objbase.h pour empaqueter les paramètres riid et ppv . Cette macro fournit l’IID correct en fonction de l’interface pointée par la valeur dans ppv, ce qui élimine la possibilité d’une erreur de codage.

Exemples

L’exemple suivant, à inclure dans le cadre d’un programme plus large, montre comment utiliser PSGetPropertySystem.

IPropertySystem *pSystem;

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

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

Spécifications


Client minimal pris en charge	Windows XP avec SP2, Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 avec SP1 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	propsys.h
Bibliothèque	Propsys.lib
DLL	Propsys.dll (version 6.0 ou ultérieure)
Composant redistribuable	Windows Desktop Search (WDS) 3.0

Partager via