Funzione ProgIDFromCLSID (combaseapi.h)

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.

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

Vedi anche

CLSIDFromProgID