Compartilhar via


Método IScanProfileMgr::CreateProfile

Cria um perfil de verificação vazio e o associa a um scanner ou a outro item wia (aquisição de imagens do Windows) 2.0.

Sintaxe

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

Parâmetros

bstrDeviceID [in]

Tipo: BSTR

A ID do dispositivo ou do item WIA 2.0.

bstrName [in]

Tipo: BSTR

O nome amigável do novo perfil.

guidCategory [in]

Tipo: GUID

O GUID da categoria do dispositivo ou do item WIA 2.0. Essa deve ser uma das constantes WIA_IPA_ITEM_CATEGORY.

ppScanProfile [out]

Tipo: IScanProfile**

O endereço de um ponteiro para o novo perfil.

Valor retornado

Tipo: HRESULT

Se esse método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT .

Comentários

IScanProfileMgr::CreateProfile associa o dispositivo especificado ao novo perfil de verificação.

IScanProfileMgr::CreateProfile gera automaticamente um GUID para o novo perfil. Obtenha o GUID com GetGUID.

Use o método IScanProfileMgr::Refresh quando mais de um objeto IScanProfileMgr pode estar criando ou excluindo perfis ao mesmo tempo.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho
Scanprofilemgr.h
IDL
Scanprofiles.idl

Confira também

IScanProfileMgr

Esquema de perfil de verificação