Metodo ISpecifyPropertyPages::GetPages (ocidl.h)
Recupera un elenco di pagine delle proprietà che possono essere visualizzate nella finestra delle proprietà di questo oggetto.
Sintassi
HRESULT GetPages(
[out] CAUUID *pPages
);
Parametri
[out] pPages
Puntatore a una struttura CAUUID allocata dal chiamante che la funzione inizializza e riempie prima che venga restituita. Il membro pElems nella struttura viene allocato dalla funzione con CoTaskMemAlloc e deve essere liberato dal chiamante con CoTaskMemFree.
Valore restituito
Questo metodo può restituire i valori restituiti standard E_OUTOFMEMORY e E_UNEXPECTED, nonché i valori seguenti.
| Codice restituito | Descrizione |
|---|---|
|
Metodo completato correttamente. |
|
L'indirizzo in pPages non è valido. Ad esempio, può essere NULL. |
Commenti
La struttura CAUUID è allocata dal chiamante, ma non viene inizializzata dal chiamante. Il metodo GetPages riempie il membro cElements nella struttura. Questo metodo alloca anche la memoria per la matrice a cui punta il membro pElems usando CoTaskMemAlloc. Riempie quindi la matrice appena allocata. Dopo che questo metodo viene restituito correttamente, la struttura contiene una matrice con conteggiata di UUID, ogni UUID che specifica un CLSID della pagina delle proprietà.
Note ai chiamanti
Il chiamante deve rilasciare la memoria a cui punta il membro pElems di CAUUID, usando CoTaskMemFree quando non è più necessario.Note per gli implementatori
E_NOTIMPL non è consentito come valore restituito, perché un oggetto senza pagine delle proprietà non deve esporre l'interfaccia ISpecifyPropertyPages .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 |