winuser.h


GetDlgCtrlID

La función GetDlgCtrlID devuelve el identificador del control especificado.

Sintaxis

int GetDlgCtrlID(
    HWND hwndCtl 	// manipulador de control
   );

Parámetros

hwndCtl: identifica el control.

Valor de retorno

Si la función tiene éxito, el valor de retorno es el identificador del control.

Si la función falla, el valor de retorno es NULL. Un valor inválido para el parámetro hwndCtl, por ejemplo, puede hacer que la función falle.

Observaciones

GetDlgCtrlID acepta manipuladores de ventanas hija tanto como manipuladores de controles de cuadros de diálogo. Una aplicación asigna un identificador a una ventana hija cuando la crea, mediante la asignación del valor del identificador al parámetro hmenu al invocar a la función CreateWindow o CreateWindowEx.

Aunque GetDlgCtrlID puede retornar un valor si hwndCtl identifica a una ventana de nivel máximo, estas ventanas no pueden tener un identificador, de modo que el valor retornado nunca puede ser válido.