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 |
|---|---|
|
Se esse sinalizador for definido, um processo filho criado com o parâmetro bInheritHandles de CreateProcess definido como TRUE herdará o identificador de objeto. |
|
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 |