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 |
---|---|
|
Se obtuvo la interfaz . |
|
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 |