Funzione OleRegGetMiscStatus (ole2.h)

Articolo
08/25/2023

Restituisce informazioni varie sulla presentazione e sui comportamenti supportati dal CLSID specificato dal Registro di sistema.

Questa funzione viene usata dagli sviluppatori di applicazioni dell'oggetto DLL personalizzate per emulare il comportamento del gestore predefinito OLE.

Sintassi

HRESULT OleRegGetMiscStatus(
  [in]  REFCLSID clsid,
  [in]  DWORD    dwAspect,
  [out] DWORD    *pdwStatus
);

Parametri

[in] clsid

CLSID della classe per cui devono essere richieste informazioni sullo stato.

[in] dwAspect

Aspetto della presentazione della classe per cui sono richieste informazioni. I valori possibili vengono acquisiti dall'enumerazione DVASPECT .

[out] pdwStatus

Puntatore alla variabile che riceve le informazioni sullo stato.

Valore restituito

Questa funzione può restituire il valore restituito standard E_OUTOFMEMORY, nonché i valori seguenti.

Codice restituito	Descrizione
S_OK	Le informazioni sullo stato sono state restituite correttamente.
REGDB_E_CLASSNOTREG	Nessun CLSID è registrato per l'oggetto classe.
REGDB_E_READREGDB	Errore di lettura dal Registro di sistema.
OLE_E_REGDB_KEY	La chiave GetMiscStatus manca dal Registro di sistema.

Commenti

Le applicazioni oggetto possono chiedere a OLE di ottenere informazioni sullo stato varie in uno dei due modi. Un modo consiste nel chiamare OleRegGetMiscStatus. L'altro consiste nel restituire OLE_S_USEREG in risposta alle chiamate dal gestore dell'oggetto predefinito a IOleObject::GetMiscStatus. OLE_S_USEREG indica al gestore predefinito di chiamare OleRegGetMiscStatus. Poiché le applicazioni a oggetti DLL non possono restituire OLE_S_USEREG, devono chiamare OleRegGetMiscStatus anziché delegare il processo al gestore dell'oggetto.

OleRegGetMiscStatus e le relative funzioni di pari livello, OleRegGetUserType, OleRegEnumFormatEtc e OleRegEnumVerbs, consentono agli sviluppatori di applicazioni di oggetti DLL personalizzate di emulare il comportamento del gestore dell'oggetto predefinito di OLE per ottenere informazioni sugli oggetti dal Registro di sistema. Usando queste funzioni, si evita il notevole lavoro di scrittura personalizzato e le insidie intrinseche nel lavoro direttamente nel Registro di sistema. Inoltre, si ottengono miglioramenti e ottimizzazioni future di queste funzioni senza dover codificarli autonomamente.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ole2.h
Libreria	Ole32.lib
DLL	Ole32.dll
Set di API	ext-ms-win-com-ole32-l1-1-3 (introdotta in Windows 10, versione 10.0.10240)

Vedi anche

IOleObject::GetMiscStatus

OleRegEnumFormatEtc

OleRegEnumVerbs

OleRegGetUserType

Share via