Método IFunctionInstance::OpenPropertyStore (functiondiscoveryapi.h)

[La detección de funciones está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores.

Abre el almacén de propiedades para la instancia de función. El almacén de propiedades contiene metadatos sobre la instancia de función, como su nombre, icono, fecha de instalación y otra información.

Sintaxis

HRESULT OpenPropertyStore(
  [in]  DWORD          dwStgAccess,
  [out] IPropertyStore **ppIPropertyStore
);

Parámetros

[in] dwStgAccess

Modo de acceso que se va a asignar a la secuencia abierta. Para este método, se admiten los siguientes modos de acceso:

STGM_READ

STGM_READWRITE

STGM_WRITE

[out] ppIPropertyStore

Puntero a un puntero de interfaz IPropertyStore .

Valor devuelto

Entre los valores devueltos posibles se incluyen, entre otros, los siguientes.

Código devuelto	Descripción
S_OK	El método se completó correctamente.
STG_E_ACCESSDENIED	El método no pudo abrir un almacén de propiedades grabable porque el autor de la llamada no tiene acceso suficiente o el proveedor de detección no permite el acceso de escritura a su almacén de propiedades.
E_INVALIDARG	El valor de dwStgAccess no es válido.
E_POINTER	PpIPropertyStore apunta a memoria no válida.
E_OUTOFMEMORY	El método no puede asignar la memoria necesaria para realizar esta operación.

Comentarios

Solo se puede abrir un almacén de propiedades por instancia de función a la vez. Si se llama a OpenPropertyStore dos veces en la misma instancia de función, ambos punteros ppIPropertyStore apuntarían al mismo almacén de propiedades. Además, el modo de acceso (según lo especificado por el parámetro dwStgAccess ) se determinaría mediante la llamada a OpenPropertyStore más reciente. Las aplicaciones deben llamar a Release para cerrar un almacén de propiedades antes de abrir otro.

Es posible que OpenPropertyStore devuelva un almacén de propiedades para un dispositivo que se haya quitado. En este caso, las claves de propiedad del almacén estarán vacías. Esta situación puede producirse si se eliminó el nodo devnode del dispositivo, pero el almacén de propiedades asociado a la instancia de función del dispositivo sigue siendo accesible. Esta situación rara vez se produce.

Requisitos

Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	functiondiscoveryapi.h
Archivo DLL	FunDisc.dll

Consulte también

IFunctionInstance