Función PSGetPropertySystem (propsys.h)

Obtiene una instancia del objeto subsistema que implementa IPropertySystem.

Sintaxis

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

Parámetros

[in] riid

Tipo: REFIID

Referencia al IID de la interfaz solicitada.

[out] ppv

Tipo: void**

Cuando se devuelve esta función, contiene el puntero de interfaz solicitado en riid. Esto suele ser IPropertySystem.

Valor devuelto

Tipo: PSSTDAPI

Devuelve uno de los valores siguientes.

Código devuelto	Descripción
S_OK	Se obtuvo la interfaz .
E_INVALIDARG	El parámetro ppv es NULL.

Comentarios

Debe inicializar component Object Model (COM) con CoInitialize o OleInitialize antes de llamar a PSGetPropertySystem. COM debe permanecer inicializado durante la vigencia de este objeto. El objeto del sistema de propiedades agrega el serializador sin subprocesos y es seguro para subprocesos.

Se recomienda usar la macro IID_PPV_ARGS definida en Objbase.h para empaquetar los parámetros riid y ppv . Esta macro proporciona el IID correcto basado en la interfaz a la que apunta el valor en ppv, lo que elimina la posibilidad de un error de codificación.

Ejemplos

En el ejemplo siguiente, que se va a incluir como parte de un programa más grande, se muestra cómo usar PSGetPropertySystem.

IPropertySystem *pSystem;

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

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

Requisitos

Cliente mínimo compatible	Windows XP con SP2, Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 con SP1 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	propsys.h
Library	Propsys.lib
Archivo DLL	Propsys.dll (versión 6.0 o posterior)
Redistribuible	Búsqueda de escritorio de Windows (WDS) 3.0