WPRCCreateInstanceUnderInstanceName
Questa funzione crea un'istanza di una classe specificata, con l'opzione per specificare il nome dell'istanza.
Sintassi
HRESULT WPRCCreateInstanceUnderInstanceName(
_In_opt_ BSTR bstrInstanceName,
_In_ REFCLSID rclsid,
_In_opt_ LPUNKNOWN pUnkOuter,
_In_ DWORD dwClsContext,
_In_ REFIID riid,
_Outptr_ LPVOID *ppv
);
Parametri
bstrInstanceName
(In_opt BSTR): facoltativo. Nome dell'istanza. Se questo parametro è NULL, la funzione crea un'istanza senza nome.
rclsid
(In REFCLSID): CLSID associato ai dati e al codice che verranno usati per creare l'oggetto.
pUnkOuter
(In_opt LPUNKNOWN): facoltativo. Se NULL, l'oggetto non viene creato come parte di un'aggregazione. Se non###NULL, puntatore all'interfaccia IUnknown dell'oggetto aggregato (controllo IUnknown).
dwClsContext
(In DWORD): contesto in cui verrà eseguito il codice che gestisce l'oggetto appena creato. I valori vengono ricavati dalla classe CLSCTX
di enumerazione .
riid
(In REFIID): riferimento all'identificatore dell'interfaccia da usare per comunicare con l'oggetto .
ppv
(Outptr LPVOID): indirizzo della variabile puntatore che riceve il puntatore dell'interfaccia richiesto in riid
. Al termine della restituzione, *ppv contiene il puntatore all'interfaccia richiesto.
Valore restituito
La funzione restituisce un codice HRESULT. Un'esecuzione riuscita viene in genere indicata da S_OK. L'errore è indicato da qualsiasi altro codice HRESULT, che indica un errore durante l'esecuzione della funzione.