Funzione ProgIDFromCLSID (combaseapi.h)

Articolo
02/24/2024

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

Condividi tramite