Condividi tramite


Funzione OleRegGetMiscStatus (ole2.h)

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