Metodo IFunctionDiscoveryProvider::InstancePropertyStoreValidateAccess (functiondiscoveryprovider.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.]

Verifica che il provider supporti l'accesso richiesto. Viene chiamato quando OpenPropertyStore viene chiamato in un'istanza di funzione per verificare che il provider supporti la modalità di accesso passata dal parametro dwStgAccess .

Questo metodo viene chiamato solo quando il metodo Initialize di un provider restituisce un valore del parametro pdwStgAccessCapabilities pari a -1.

Sintassi

HRESULT InstancePropertyStoreValidateAccess(
  [in] IFunctionInstance *pIFunctionInstance,
  [in] INT_PTR           iProviderInstanceContext,
  [in] const DWORD       dwStgAccess
);

Parametri

[in] pIFunctionInstance

Puntatore all'interfaccia IFunctionInstance .

[in] iProviderInstanceContext

Contesto associato all'istanza della funzione specifica.

[in] dwStgAccess

Modalità di accesso da verificare. Per questo metodo sono supportate le modalità seguenti:

STGM_READ

STGM_READWRITE

STGM_WRITE

Valore restituito

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

Codice restituito	Descrizione
S_OK	Metodo completato correttamente.
E_NOTIMPL	Il provider non implementa un archivio delle proprietà dell'istanza.
STG_E_ACCESSDENIED	Il metodo non è riuscito ad aprire un archivio delle proprietà scrivibile perché il chiamante non ha accesso sufficiente, il provider di individuazione non consente l'accesso in scrittura all'archivio delle proprietà o un altro archivio proprietà è già aperto per questa istanza della funzione.
E_INVALIDARG	Il valore di dwStgAccess non è valido.
E_OUTOFMEMORY	Il metodo non è in grado di allocare la memoria necessaria per eseguire questa operazione.

Commenti

Il significato preciso del valore restituito STG_E_ACCESSDENIED è specifico dell'implementazione. Quando si implementa il metodo InstancePropertyStoreValidateAccess , è possibile restituire STG_E_ACCESSDENIED per qualsiasi valore della modalità dwStgAccess fornito in qualsiasi istanza di funzione fornita.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	functiondiscoveryprovider.h

Vedi anche

IFunctionDiscoveryProvider