Share via


Função WcsSetUsePerUserProfiles (icm.h)

Permite que um usuário especifique se deve ou não usar uma lista de associação de perfil por usuário para o dispositivo especificado.

Sintaxe

BOOL WcsSetUsePerUserProfiles(
  LPCWSTR pDeviceName,
  DWORD   dwDeviceClass,
  BOOL    usePerUserProfiles
);

Parâmetros

pDeviceName

Um ponteiro para uma cadeia de caracteres que contém o nome amigável do dispositivo.

dwDeviceClass

Um valor de sinalizador que especifica a classe do dispositivo. Esse parâmetro deve ter um dos seguintes valores:

Valor Descrição
CLASS_MONITOR Especifica um dispositivo de exibição.
CLASS_PRINTER Especifica uma impressora.
CLASS_SCANNER Especifica um dispositivo de captura de imagem.

usePerUserProfiles

Um valor booliano verdadeiro se o usuário quiser usar uma lista de associação de perfil por usuário para o dispositivo especificado; caso contrário , FALSE.

Retornar valor

Se essa função for bem-sucedida, o valor retornado será TRUE.

Se essa função falhar, o valor retornado será FALSE. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Se usePerUserProfiles for TRUE e o usuário ainda não estiver usando uma lista de associação de perfil por usuário para pDeviceName, a lista de associação de perfil por usuário será inicializada fazendo uma cópia da lista de associação de perfil em todo o sistema para o mesmo dispositivo. A partir daí, as alterações na lista de todo o sistema não são incluídas na lista por usuário.

Essa função é executável no contexto da conta de usuário Least-Privileged (LUA).

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho icm.h
Biblioteca Mscms.lib
DLL Mscms.dll

Confira também