Metodo IOleObject::GetMiscStatus (oleidl.h)
Recupera lo stato di un oggetto in fase di creazione e caricamento.
Sintassi
HRESULT GetMiscStatus(
[in] DWORD dwAspect,
[out] DWORD *pdwStatus
);
Parametri
[in] dwAspect
Aspetto di un oggetto su cui vengono richieste informazioni sullo stato. Il valore viene ottenuto dall'enumerazione DVASPECT.
[out] pdwStatus
Puntatore alla posizione in cui vengono restituite le informazioni sullo stato. Questo parametro non può essere NULL.
Valore restituito
Questo metodo restituisce S_OK se l'operazione ha esito positivo. Gli altri valori restituiti possibili includono i seguenti:
Codice restituito | Descrizione |
---|---|
|
Delegare il recupero di informazioni sullo stato varie all'implementazione del gestore predefinito di questo metodo. |
|
Nessun CLSID registrato per l'oggetto. |
|
Errore durante l'accesso al Registro di sistema. |
Commenti
Un contenitore chiama normalmente IOleObject::GetMiscStatus quando crea o carica un oggetto per determinare come visualizzare l'oggetto e quali tipi di comportamenti supporta.
Gli oggetti archiviano le informazioni sullo stato nel Registro di sistema. Se l'oggetto non è in esecuzione, l'implementazione del gestore predefinito di IOleObject::GetMiscStatus recupera queste informazioni dal Registro di sistema. Se l'oggetto è in esecuzione, il gestore predefinito richiama IOleObject::GetMiscStatus nell'oggetto stesso.
Le informazioni effettivamente archiviate nel Registro di sistema variano con singoli oggetti. I valori di stato da restituire sono definiti nell'enumerazione OLEMISC.
Il valore predefinito di IOleObject::GetMiscStatus viene usato se non viene trovata una sottochiave corrispondente all'oggetto DVASPECT specificato. Per impostare un controllo OLE, specificare DVASPECT==1. In questo modo si verificherà quanto segue nel Registro di sistema:
HKEY_CLASSES_ROOT\CLSID\ . . . MiscStatus = 1
Note per gli implementatori
L'implementazione è in genere costituita dalla delega della chiamata al gestore predefinito.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 | oleidl.h |