Metodo IPerPropertyBrowsing::GetPredefinedValue (ocidl.h)

Articolo
08/25/2023

Recupera il valore della proprietà specificata associata a un nome stringa predefinito. Questa proprietà è associata a un nome stringa predefinito come restituito da IPerPropertyBrowsing::GetPredefinedStrings. La stringa predefinita viene identificata da un token restituito da GetPredefinedStrings.

Sintassi

HRESULT GetPredefinedValue(
  [in]  DISPID  dispID,
  [in]  DWORD   dwCookie,
  [out] VARIANT *pVarOut
);

Parametri

[in] dispID

Identificatore di invio della proprietà per cui viene richiesto un valore predefinito.

[in] dwCookie

Token che identifica il valore da restituire. Il token è stato restituito in precedenza nella matrice pCaCookiesOut riempita da GetPredefinedStrings.

[out] pVarOut

Puntatore al valore VARIANT per la proprietà.

Valore restituito

Questo metodo può restituire i valori restituiti standard E_INVALIDARG, E_OUTOFMEMORY e E_UNEXPECTED, nonché i valori seguenti.

Codice restituito	Descrizione
S_OK	Metodo completato correttamente.
E_NOTIMPL	Questo oggetto non supporta stringhe predefinite o valori predefiniti.
E_POINTER	L'indirizzo in pVarOut non è valido. Ad esempio, può essere NULL.

Commenti

Note ai chiamanti

Il chiamante è responsabile della liberazione di qualsiasi allocazione contenuta in VARIANT. A meno che il membro vt di VARIANT non sia VT_VARIANT, il chiamante può liberare memoria usando una singola chiamata a VariantClear. In caso contrario, il chiamante deve liberare in modo ricorsivo i valori VARIANT contenuti prima di liberare l'esterno VARIANT.

Note per gli implementatori

Il supporto per nomi e valori predefiniti non è obbligatorio. Se l'oggetto non supporta questi nomi, restituire E_NOTIMPL da questo metodo. Se questo metodo non viene implementato, non è necessario implementare IPerPropertyBrowsing::GetPredefinedStrings .

Questo metodo alloca qualsiasi memoria necessaria all'interno di VARIANT.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ocidl.h

Vedi anche

IPerPropertyBrowsing

Condividi tramite