Funzione OleRegGetUserType (ole2.h)

Ottiene il tipo di utente della classe specificata dal Registro di sistema.

Gli sviluppatori di applicazioni oggetti DLL personalizzate usano questa funzione per emulare il comportamento del gestore predefinito OLE.

Sintassi

HRESULT OleRegGetUserType(
  [in]  REFCLSID clsid,
  [in]  DWORD    dwFormOfType,
  [out] LPOLESTR *pszUserType
);

Parametri

[in] clsid

CLSID della classe per cui deve essere richiesto il tipo di utente.

[in] dwFormOfType

Forma della stringa presentabile dall'utente. I valori possibili vengono ricavati dall'enumerazione USERCLASSTYPE.

[out] pszUserType

Puntatore a una stringa che riceve il tipo di utente.

Valore restituito

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

Codice restituito	Descrizione
S_OK	Il tipo di utente è stato restituito correttamente.
REGDB_E_CLASSNOTREG	Nessun CLSID è registrato per l'oggetto classe.
REGDB_E_READREGDB	Si è verificato un errore durante la lettura dal Registro di sistema.
OLE_E_REGDB_KEY	Le chiavi ProgID = MainUserTypeName e CLSID = MainUserTypeName mancano nel Registro di sistema.

Commenti

Le applicazioni oggetto possono chiedere a OLE di ottenere il nome del tipo utente di una classe specificata in uno dei due modi seguenti. Un modo consiste nel chiamare OleRegGetUserType. L'altro consiste nel restituire OLE_S_USEREG in risposta alle chiamate dal gestore dell'oggetto predefinito a IOleObject::GetUserType. OLE_S_USEREG indica al gestore predefinito di chiamare OleRegGetUserType. Poiché le applicazioni oggetto DLL non possono restituire OLE_S_USEREG, devono chiamare OleRegGetUserType, anziché delegare il processo al gestore oggetti.

La funzione OleRegGetUserType e le relative funzioni di pari livello , OleRegGetMiscStatus, OleRegEnumFormatEtc e OleRegEnumVerbs consentono agli sviluppatori di applicazioni di oggetti DLL personalizzate di emulare il comportamento del gestore oggetti predefinito di OLE per ottenere informazioni sugli oggetti dal Registro di sistema. Usando queste funzioni, si evitano le notevoli operazioni di scrittura personalizzate e le insidie intrinseche nel lavorare direttamente nel Registro di sistema. Inoltre, si ottengono miglioramenti e ottimizzazioni futuri di queste funzioni senza dover codificarli manualmente.

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	ole2.h
Libreria	Ole32.lib
DLL	Ole32.dll
Set di API	ext-ms-win-com-ole32-l1-1-3 (introdotto in Windows 10, versione 10.0.10240)

Vedi anche

IOleObject::GetUserType

OleRegEnumFormatEtc

OleRegEnumVerbs

OleRegGetMiscStatus