macro CLUSCTL_USER_CODE (clusapi.h)

Gera um código de controle definido pelo usuário formatado corretamente. Para obter mais informações sobre o layout de bit dos códigos de controle, consulte Arquitetura de código de controle.

Sintaxe

void CLUSCTL_USER_CODE(
  Function,
  Object
);

Parâmetros

Function

Valor que especifica o código de operação (bits 0–23) e, opcionalmente, o código de acesso (bits 0–1) do código de controle resultante. O código de operação pode ser qualquer valor de 19 bits escolhido pelo chamador. O código de acesso (se especificado) deve ser definido como um dos valores a seguir.

0 (CLUS_ACCESS_ANY)

O código de controle não tem requisitos de acesso.

1 (CLUS_ACCESS_READ)

O uso do código de controle requer acesso de leitura.

2 (CLUS_ACCESS_WRITE)

O uso do código de controle requer acesso de gravação.

Object

Um valor de 8 bits que especifica o código do objeto (bits 24–31) do código de controle resultante. Para obter mais informações sobre o layout de bit dos códigos de controle, consulte Arquitetura de código de controle. O código do objeto pode ser definido como qualquer valor maior que CLUS_OBJECT_USER (128).

Retornar valor

Nenhum

Comentários

Não passe valores com deslocamento de bit para Função ou Objeto. A macro executa as mudanças de bits necessárias.

Se nenhum código de acesso for especificado, o código de controle usará como padrão CLUS_ACCESS_ANY.

Exemplos

Consulte o exemplo em Criando códigos de controle.

Requisitos

Confira também

CLUSCTL_GET_ACCESS_MODE

CLUSCTL_GET_CONTROL_FUNCTION

CLUSCTL_GET_CONTROL_OBJECT