Função GetHandleInformation (handleapi.h)
Recupera determinadas propriedades de um identificador de objeto.
Sintaxe
BOOL GetHandleInformation(
[in] HANDLE hObject,
[out] LPDWORD lpdwFlags
);
Parâmetros
[in] hObject
Um identificador para um objeto cujas informações devem ser recuperadas.
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.
[out] lpdwFlags
Um ponteiro para uma variável que recebe um conjunto de sinalizadores de bits que especificam propriedades do identificador de objeto ou 0. Os valores a seguir são definidos.
| 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.
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] |
| Plataforma de Destino | Windows |
| Cabeçalho | handleapi.h (inclua Windows.h) |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |