Función SetHandleInformation (handleapi.h)
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 |
---|---|
|
Si se establece esta marca, un proceso secundario creado con el parámetro bInheritHandles de CreateProcess establecido en TRUE heredará el identificador de objeto. |
|
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 |