IOPCItemProperties::QueryAvailableProperties

Previous  Top  Next

HRESULT   QueryAvailableProperties(

[in] LPWSTR szItemID,

[out] DWORD * pdwCount,

[out, size_is(,*pdwCount)] DWORD **ppPropertyIDs,

[out, size_is(,*pdwCount)] LPWSTR *ppDescriptions,

[out, size_is(,*pdwCount)] VARTYPE **ppvtDataTypes

);

Descrizione
Restituisce un elenco di codici ID e descrizioni per attributi disponibili degli ITEMID. Questi elenchi possono differire per differenti ItemIDs. Ci si aspetta che queste elenchi siano relativamente stabili per il particolare ItemID. Cioè i cambiamenti non sono frequenti

Parametri	Descrizione
SzItemID	L'ItemID del quale il chiamante vuol conoscere le proprietà disponibili
PdwCount	Il numero di proprietà restituite
PpPropertyIDs	DWORD IDs Per le proprietà restituite. Questi possono essere passati a GetItemProperties o LookupItemIDs
PpDescriptions	Una breve desrizione fornita dal venditore per ognuna delle proprietà.
PpvtDataTypes	Il tipo del dato che sarà restituito per questa proprietà da GetItemProperties.

Codici Restituiti

Codici Restituiti	Descrizione
S_OK	L'operazione ha avuto successo.
OPC_E_UNKNOWNITEMID	L' ItemID non si trova nello spazio degli indirizzi del server
OPC_E_INVALIDITEMID	L' ItemID non è sintatticamente valido
E_OUTOFMEMORY	Non c'è memoria a sufficienza.
E_INVALIDARG	Un argomento passato alla funzione era invalido
E_FAIL	La funzione non ha avuto successo..

Commenti
L'ItemID viene passato a questa funzione affinché i servers possano restituire insiemi differenti di proprietà per diversi ItemIDs.