Función SetHandleInformation (handleapi.h)

  • Artículo

Establece determinadas propiedades de un identificador de objeto.

Sintaxis

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

Parámetros

[in] hObject

Identificador de un objeto cuya información se va a establecer.

Puede especificar un identificador para uno de los siguientes tipos de objetos: token de acceso, búfer de entrada de consola, búfer de pantalla de consola, evento, archivo, asignación de archivos, trabajo, mailslot, exclusión mutua, canalización, impresora, proceso, clave del Registro, semáforo, dispositivo de comunicación serie, socket, subproceso o temporizador esperable.

[in] dwMask

Máscara que especifica las marcas de bits que se van a cambiar. Use las mismas constantes que se muestran en la descripción de dwFlags.

[in] dwFlags

Conjunto de marcas de bits que especifica las propiedades del identificador de objeto. Este parámetro puede ser 0 o uno o varios de los valores siguientes.

Valor Significado
HANDLE_FLAG_INHERIT
0x00000001
 Si se establece esta marca, un proceso secundario creado con el parámetro bInheritHandles de CreateProcess establecido en TRUE heredará el identificador de objeto.
HANDLE_FLAG_PROTECT_FROM_CLOSE
0x00000002
 Si se establece esta marca, al llamar a la función CloseHandle no se cerrará el identificador de objeto.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Para establecer o borrar la marca de bits asociada en dwFlags, debe establecer una marca de bits de máscara de cambio en dwMask.

Requisitos

   
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado handleapi.h (incluir Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

CloseHandle

CreateProcess

GetHandleInformation

Funciones handle y object