Metodo IFunctionInstance::OpenPropertyStore (functiondiscoveryapi.h)

[L'individuazione delle funzioni è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Potrebbe essere modificato o non disponibile nelle versioni successive.]

Apre l'archivio delle proprietà per l'istanza della funzione. L'archivio delle proprietà contiene metadati relativi all'istanza della funzione, ad esempio il nome, l'icona, la data di installazione e altre informazioni.

Sintassi

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

Parametri

[in] dwStgAccess

Modalità di accesso da assegnare al flusso aperto. Per questo metodo sono supportate le modalità di accesso seguenti:

STGM_READ

STGM_READWRITE

STGM_WRITE

[out] ppIPropertyStore

Puntatore a un puntatore all'interfaccia IPropertyStore .

Valore restituito

I valori restituiti possibili includono, ma non sono limitati ai valori seguenti.

Codice restituito	Descrizione
S_OK	Metodo completato correttamente.
STG_E_ACCESSDENIED	Il metodo non è riuscito ad aprire un archivio delle proprietà scrivibile perché il chiamante non dispone di accesso sufficiente o il provider di individuazione non consente l'accesso in scrittura al relativo archivio proprietà.
E_INVALIDARG	Il valore di dwStgAccess non è valido.
E_POINTER	PpIPropertyStore punta a memoria non valida.
E_OUTOFMEMORY	Il metodo non è in grado di allocare la memoria necessaria per eseguire questa operazione.

Commenti

È possibile aprire un solo archivio di proprietà per ogni istanza di funzione alla volta. Se OpenPropertyStore viene chiamato due volte nella stessa istanza della funzione, entrambi i puntatori ppIPropertyStore puntano allo stesso archivio delle proprietà. Inoltre, la modalità di accesso (come specificato dal parametro dwStgAccess ) viene determinata dalla chiamata OpenPropertyStore più recente. Le applicazioni devono chiamare Release per chiudere un archivio delle proprietà prima di aprire un altro.

È possibile che OpenPropertyStore restituisca un archivio delle proprietà per un dispositivo rimosso. In questo caso, le chiavi delle proprietà nell'archivio saranno vuote. Questa situazione può verificarsi se il nodo devnode del dispositivo è stato eliminato, ma l'archivio delle proprietà associato all'istanza della funzione del dispositivo è ancora accessibile. Questa situazione si verifica raramente.

Requisiti

Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	functiondiscoveryapi.h
DLL	FunDisc.dll

Vedi anche

IFunctionInstance