Metodo IScanProfileMgr::CreateProfile

Crea un profilo di analisi vuoto e lo associa a uno scanner o a un altro elemento wia (Windows Image Acquisition) 2.0.

Sintassi

HRESULT CreateProfile(
  [in]  BSTR         bstrDeviceID,
  [in]  BSTR         bstrName,
  [in]  GUID         guidCategory,
  [out] IScanProfile **ppScanProfile
);

Parametri

bstrDeviceID [in]

Tipo: BSTR

ID del dispositivo o dell'elemento WIA 2.0.

bstrName [in]

Tipo: BSTR

Nome descrittivo del nuovo profilo.

guidCategory [in]

Tipo: GUID

GUID della categoria del dispositivo o dell'elemento WIA 2.0. Deve essere una delle costanti WIA_IPA_ITEM_CATEGORY.

ppScanProfile [out]

Tipo: IScanProfile**

Indirizzo di un puntatore al nuovo profilo.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

IScanProfileMgr::CreateProfile associa il dispositivo specificato al nuovo profilo di analisi.

IScanProfileMgr::CreateProfile genera automaticamente un GUID per il nuovo profilo. Ottenere il GUID con GetGUID.

Usare il metodo IScanProfileMgr::Refresh quando più oggetti IScanProfileMgr potrebbero creare o eliminare profili contemporaneamente.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Intestazione	Scanprofilemgr.h
IDL	Scanprofiles.idl

Vedi anche

IScanProfileMgr

Schema del profilo di analisi