Compartilhar via


Função SetHandleInformation (handleapi.h)

Define determinadas propriedades de um identificador de objeto.

Sintaxe

BOOL SetHandleInformation(
  [in] HANDLE hObject,
  [in] DWORD  dwMask,
  [in] DWORD  dwFlags
);

Parâmetros

[in] hObject

Um identificador para um objeto cujas informações devem ser definidas.

Você pode especificar um identificador para um dos seguintes tipos de objetos: token de acesso, buffer de entrada do console, buffer de tela do console, evento, arquivo, mapeamento de arquivos, trabalho, maillot, mutex, pipe, impressora, processo, chave do registro, semáforo, dispositivo de comunicação serial, soquete, thread ou temporizador de espera.

[in] dwMask

Uma máscara que especifica os sinalizadores de bit a serem alterados. Use as mesmas constantes mostradas na descrição de dwFlags.

[in] dwFlags

Conjunto de sinalizadores de bits que especifica as propriedades do identificador de objeto. Esse parâmetro pode ser 0 ou um ou mais dos valores a seguir.

Valor Significado
HANDLE_FLAG_INHERIT
0x00000001
Se esse sinalizador for definido, um processo filho criado com o parâmetro bInheritHandles de CreateProcess definido como TRUE herdará o identificador de objeto.
HANDLE_FLAG_PROTECT_FROM_CLOSE
0x00000002
Se esse sinalizador estiver definido, chamar a função CloseHandle não fechará o identificador do objeto.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

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

Comentários

Para definir ou limpar o sinalizador de bit associado em dwFlags, você deve definir um sinalizador de bit de máscara de alteração no dwMask.

Requisitos

   
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]
Plataforma de Destino Windows
Cabeçalho handleapi.h (inclua Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

CloseHandle

CreateProcess

GetHandleInformation

Funções de identificador e objeto