Função WindowsInspectString2 (winstring.h)
Fornece uma maneira de os depuradores exibirem o valor de um Windows Runtime HSTRING em outro espaço de endereço, remotamente ou de um despejo.
Sintaxe
HRESULT WindowsInspectString2(
UINT64 targetHString,
USHORT machine,
PINSPECT_HSTRING_CALLBACK2 callback,
void *context,
UINT32 *length,
UINT64 *targetStringAddress
);
Parâmetros
targetHString
[in]
O HSTRING a ser inspecionado.
machine
O formato do espaço de endereço de destino. Os valores válidos são IMAGE_FILE_MACHINE_AMD64 para Win64, IMAGE_FILE_MACHINE_I386 para Win32 ou IMAGE_FILE_MACHINE_ARM para ARM de 32 bits.
callback
[in]
Uma função de retorno de chamada para ler o buffer de cadeia de caracteres do espaço de endereço de destino. Essa função é chamada antes que os parâmetros length e targetStringAddress sejam calculados pela função WindowsInspectString2 .
context
[in, opcional]
Dados de contexto personalizados passados para o retorno de chamada.
length
[out]
O comprimento da cadeia de caracteres no espaço de endereço de destino, se a chamada para retorno de chamada for bem-sucedida; caso contrário, 0.
targetStringAddress
[out]
O endereço de destino do PCWSTR bruto, se a chamada para retorno de chamada for bem-sucedida; caso contrário, NULL.
Retornar valor
Essa função pode retornar um desses valores.
| Código de retorno | Descrição |
|---|---|
|
|
Comentários
A função WindowsInspectString passa os ponteiros de entrada e saída como valores nativos do tamanho do ponteiro. Se a plataforma atual for Win32, essa função retornará um erro para processos que são Win64.
O WindowsInspectString2 permite a depuração entre arquiteturas permitindo valores de até 64 bits quando chamados de aplicativos Win32 e Win64.
Requisitos
| Cliente mínimo com suporte | Windows 8 |
| Servidor mínimo com suporte | Windows Server 2012 |
| Plataforma de Destino | Windows |
| Cabeçalho | winstring.h |
| Biblioteca | RuntimeObject.lib |
| DLL | ComBase.dll |