Condividi tramite

Funzione ProgIDFromCLSID (combaseapi.h)

  • Articolo

Recupera il ProgID per un CLSID specificato.

Sintassi

HRESULT ProgIDFromCLSID(
  [in]  REFCLSID clsid,
  [out] LPOLESTR *lplpszProgID
);

Parametri

[in] clsid

CLSID per il quale deve essere richiesto il ProgID.

[out] lplpszProgID

Indirizzo di una variabile del puntatore che riceve la stringa ProgID. La stringa che rappresenta clsid include parentesi graffe racchiuse.

Valore restituito

Questa funzione può restituire i valori seguenti.

Codice restituito Descrizione
S_OK
 Il ProgID è stato restituito correttamente.
REGDB_E_CLASSNOTREG
 Classe non registrata nel Registro di sistema.
REGDB_E_READREGDB
 Si è verificato un errore durante la lettura dal Registro di sistema.

Commenti

Ogni classe oggetto OLE elencata nella finestra di dialogo Inserisci oggetto deve avere un identificatore programmatico (ProgID), una stringa che identifica in modo univoco una determinata classe archiviata nel Registro di sistema. Oltre a determinare l'idoneità per la finestra di dialogo Inserisci oggetto , il ProgID può essere usato come identificatore in un linguaggio di programmazione macro per identificare una classe. Infine, ProgID è anche il nome della classe usato per un oggetto di una classe OLE inserita in un contenitore OLE 1.

ProgIDFromCLSID usa le voci nel Registro di sistema per eseguire la conversione. Gli autori di applicazioni OLE sono responsabili della corretta configurazione del Registro di sistema nel programma di installazione dell'applicazione.

La stringa ProgID deve essere diversa dal nome della classe di qualsiasi applicazione OLE 1, inclusa la versione OLE 1 della stessa applicazione, se presente. Inoltre, una stringa ProgID non deve contenere più di 39 caratteri, iniziare con una cifra o, ad eccezione di un singolo punto, contenere qualsiasi punteggiatura (inclusi i caratteri di sottolineatura).

Il ProgID non deve mai essere visualizzato all'utente nell'interfaccia utente. Se è necessaria una stringa breve visualizzabile per un oggetto, chiamare IOleObject::GetUserType.

Chiamare la funzione CLSIDFromProgID per trovare il CLSID associato a un progID specificato. Assicurarsi di liberare il ProgID restituito al termine dell'operazione chiamando la funzione CoTaskMemFree .

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 combaseapi.h (include Objbase.h)
Libreria Ole32.lib
DLL Ole32.dll

Vedi anche

CLSIDFromProgID