Metodo IOleObject::GetMiscStatus (oleidl.h)

Articolo
03/15/2023

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
OLE_S_USEREG	Delegare il recupero di informazioni sullo stato varie all'implementazione del gestore predefinito di questo metodo.
CO_E_CLASSNOTREG	Nessun CLSID registrato per l'oggetto.
CO_E_READREGDB	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