Método IDebugRegisters2::SetValues2 (dbgeng.h)
El método SetValues2 establece el valor de varios de los registros del destino.
Sintaxis
HRESULT SetValues2(
[in] ULONG Source,
[in] ULONG Count,
[in, optional] PULONG Indices,
[in] ULONG Start,
[in] PDEBUG_VALUE Values
);
Parámetros
[in] Source
Especifica el origen de registro que se va a consultar.
Los valores posibles se enumeran en la tabla siguiente.
| Valor | Registro del origen |
|---|---|
| DEBUG_REGSRC_DEBUGGEE | Capturar información de registro del destino. |
| DEBUG_REGSRC_EXPLICIT | Capturar información de registro del contexto de registro explícito actual. |
| DEBUG_REGSRC_FRAME |
Capturar información de registro del contexto de registro del ámbito actual.
Nota El desenredado de la pila no garantiza una actualización precisa del contexto de registro, por lo que es posible que el contexto de registro del marco de ámbito no sea preciso en todos los casos.
|
[in] Count
Especifica el número de registros para los que se van a establecer los valores.
[in, optional] Indices
Especifica una matriz que contiene los índices de los registros para los que se van a establecer los valores. El número de elementos de esta matriz es Count. Si Indexs es NULL, se usa Start en su lugar.
[in] Start
Si Los índices son NULL, los registros se establecerán consecutivamente a partir de este índice. De lo contrario, se omite.
[in] Values
Matriz que contiene los valores en los que se van a establecer los registros. El número de elementos que contiene esta matriz es Count. Consulte DEBUG_VALUE para obtener una descripción de este tipo de parámetro.
Valor devuelto
Esta lista no contiene todos los errores que pueden producirse. Para obtener una lista de posibles errores, consulte Valores HRESULT.
| Código devuelto | Descripción |
|---|---|
|
Método realizado correctamente. |
Comentarios
El motor hace lo mejor para convertir los valores en Valores en el tipo de los registros; esta conversión es la misma que la realizada por CoerceValue. Si el valor es mayor que lo que puede contener el registro, se quitan los bits menos significativos. Las conversiones de enteros y de punto flotante también se realizarán si es necesario.
Si el valor devuelto no es S_OK, es posible que algunos de los registros todavía se hayan establecido.
Cuando se modifica un subregistro, también se modifica el registro que lo contiene.
El método SetValues realiza la misma tarea que este método, pero siempre usa el destino como origen del registro.
Para obtener información general sobre la interfaz IDebugRegisters y otros métodos relacionados con el registro, consulte Registros.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Escritorio |
| Encabezado | dbgeng.h (include DbgEng.h) |